Docs

Volcano Engine Function as a Service

Trigger management

Creating BMQ triggers

veFaaS can be integrated with Bytedance Message Queue (BMQ) of Volcano Engine. You can create a BMQ trigger. In this way, veFaaS will consume messages from BMQ as a consumer and pass the messages to the user function. This triggers function code execution. You only need to write the function that processes the messages without the need to worry about the details of how veFaaS consumes messages. This topic describes how to create BMQ triggers.

Prerequisites

The VPC access feature has been enabled for the target function, which needs to be deployed in the same VPC as the BMQ instance to be used. For detailed operations, see Configuring functions.

After enabling or modifying the VPC access configuration of the function, you need to perform a full release again. For detailed operations, refer to Releasing a function.

A BMQ instance, Topic, and Consumer Group have been created. For detailed operations, see Getting started with BMQ.

Limits

You can create up to 20 triggers for each function.

The BMQ instance and function must be deployed in the same VPC.

To modify the VPC or subnet of a function, you must first disable or delete all MQ triggers.

After a BMQ trigger is created, you cannot change its BMQ instance, Topic, or Consumer Group.

Procedure

In the top navigation bar, select the target region.

In the function list, find the function for which you want to create a trigger and click its name.

On the function details page, click Create trigger on the Trigger tab.

In the Create trigger panel, specify the parameters as required.

Parameter	Description
Trigger type	In this scenario, select BMQ.
Trigger name	Specify a custom name for the trigger. Trigger names cannot be repeated under the same function. The trigger name cannot be modified after being created.
Instance	The BMQ instance. veFaaS will act as the specified Consumer Group to consume messages from the specified Topic in the specified BMQ instance. Select the BMQ instance, Topic, and Consumer Group described in the prerequisites. Topic: A message topic is a collection of messages of the same type and is the basic unit for message subscription in BMQ. Consumer Group: A consumer group is a group of consumers with the same Group ID. A consumer group enables messages in a Topic to be consumed in parallel. tip You can only select a BMQ instance that is deployed in the same VPC as the function.
Number of retries	The maximum number of retries when a function has run errors, including user code errors and runtime errors.
Consumer offset	Specifies where to start consuming messages in the Topic. You can select Consume from the beginning or Consume from the latest offset. Select an appropriate position based on your business requirements. After the consumption position is specified, it cannot be changed. Consume from the beginning: Start consuming from the first message produced in the Topic. Consume from the latest offset: Only consume messages produced after the Topic is subscribed.
Activate now	Whether to enable the Trigger while creating it. Only Trigger enabled will work properly.
Description	Enter remarks as needed.

Click Confirm to create the BMQ trigger.

What to do next

For the method of modifying the configurations of a trigger, see Managing triggers.

For the method of monitoring the running status of the function, see Monitoring and logging.

Last updated: 2026.08.19 14:06:06