Updated on 2026-10-27 GMT+08:00

Obtaining the Trigger List

Function

This API is used to obtain the trigger list.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

GET /v2/{project_id}/fgs/triggers

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description:

Project ID. For details, see Obtaining a Project ID.

Constraints

N/A

Value range:

32 characters, including letters and digits.

Default value:

N/A

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

marker

No

String

Offset.

maxitems

No

String

Maximum number of records that can be queried.

trigger_type

No

String

Trigger type.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Parameter description:

User token.

The token can be obtained by calling the IAM API. The value of X-Subject-Token in the response header is the user token.

Constraints

N/A

Value range:

N/A

Default value:

N/A

Content-Type

No

String

Parameter description:

The request body type or format.

Constraints

N/A

Value range:

Only application/json is supported.

Default value:

application/json

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

triggers

Array of ListTriggerResult objects

Trigger list.

next_marker

Long

Next query location.

total_count

Long

Total number of triggers.

Table 5 ListTriggerResult

Parameter

Type

Description

trigger_id

String

Trigger ID.

trigger_type_code

String

Definition

Trigger type code.

Range

  • TIMER

  • CTS

  • DDS

  • DMS

  • DIS

  • LTS

  • OBS

  • SMN

  • KAFKA

  • RABBITMQ

  • DEDICATEDGATEWAY

  • OPENSOURCEKAFKA

  • APIC

  • GAUSSMONGO

  • EVENTGRID

  • IOTDA

  • ROCKETMQ

  • DYNAMODB

trigger_status

String

Trigger status.

  • ACTIVE: The trigger is enabled.

  • DISABLED: The trigger is disabled.

event_data

TriggerEventDataResponseBody object

Trigger source event.

last_updated_time

String

Latest update time.

created_time

String

Time when the trigger was created.

func_urn

String

Function URN.

Table 6 TriggerEventDataResponseBody

Parameter

Type

Description

name

String

Parameter description:

Specifies the trigger name.

Range:

None

schedule_type

String

Parameter description:

Timer trigger type (timer trigger parameter).

Range

  • Rate: specifies the frequency (minutes, hours, or days) at which the function is invoked. If the unit is minute, the value cannot exceed 60. If the unit is hour, the value cannot exceed 24. If the unit is day, the value cannot exceed 30.

  • Cron: specifies a Cron expression to periodically invoke a function.

schedule

String

Parameter description:

Triggering rule. (timer trigger parameter).

Range

When the trigger type is Rate, the scheduled rule is used.

When the trigger type is Cron, the Cron expression is used.

user_event

String

Parameter description:

Additional information (timer trigger parameter).

When the Timer trigger triggers function execution, the execution event (event parameter of the function) is as follows:

{"version": "v1.0",

"time": "2018-06-01T08:30:00+08:00",

"trigger_type": "TIMER",

"trigger_name": "Timer_001",

"user_event": "Additional information you entered."

Value range:

N/A

triggerid

String

Parameter description:

APIG trigger ID (APIG trigger parameter).

Range:

None

type

Integer

Parameter description:

API type (APIG trigger parameter).

Range

  • 1: Public API.

  • 2: Private API.

path

String

Parameter description:

Path of the API (APIG trigger parameter).

Range

The value must comply with the URI naming rules.

protocol

String

Parameter description:

Request protocol of the API (APIG trigger parameter).

Range

HTTP: HTTP protocol

HTTPS: HTTPS protocol

req_method

String

Parameter description:

Request mode of the API (APIG trigger parameter).

Range

GET: triggered by an HTTP GET request

POST: triggered by an HTTP POST request

PUT: triggered by an HTTP PUT request

DELETE: triggered by an HTTP DELETE request

HEAD: triggered by an HTTP HEAD request

PATCH: triggered by an HTTP PATCH request

OPTIONS: triggered by an HTTP OPTIONS request

ANY: triggered by any HTTP request

group_id

String

Parameter description:

ID of the group to which the API belongs (APIG trigger parameter).

Range:

None

group_name

String

Parameter description:

Name of the group to which the API belongs (APIG trigger parameter).

Range:

None

match_mode

String

Parameter description:

Matching mode of the API (APIG trigger parameter).

Range

  • SWA: Prefix match

  • NORMAL (default): Exact match

env_name

String

Parameter description:

Environment in which the API is published (APIG trigger parameter).

Range:

None

env_id

String

Parameter description:

ID of the environment in which the API has been published (APIG trigger parameter).

Range:

None

api_id

String

Parameter description:

API ID (APIG trigger parameter).

Range:

None

api_name

String

Parameter description:

API name (APIG trigger parameter).

Range:

None

auth

String

Parameter description:

Security authentication (APIG trigger parameter).

Range

IAM: IAM authentication. This mode grants access permissions to IAM users only and is of medium security.

APP: AppKey and AppSecret authentication. This mode is of high security and is recommended.

NONE: Authentication is not required. All users can access this API. This mode is not recommended.

invoke_url

String

Parameter description:

API calling address (APIG trigger parameter).

Range:

None

func_info

ApigTriggerFuncInfo object

Parameter description:

Function backend information corresponding to the APIG trigger.

Range:

None

sl_domain

String

Parameter description:

Subdomain name allocated by the APIG system by default (APIG trigger parameter).

Range:

None

backend_type

String

Parameter description:

Backend type of the API (APIG trigger parameter).

Range

FUNCTION

instance_id

String

Parameter description:

Instance ID. This parameter is mandatory for DDS, RabbitMQ, and RocketMQ and Kafka triggers.

Range

APIG trigger: APIG gateway ID.

DDS trigger: DDS instance ID.

Kafka trigger: Kafka instance ID.

RabbitMQ trigger: RabbitMQ instance ID.

RocketMQ trigger: RocketMQ instance ID.

instance_ip

String

Parameter description:

Database IP address (DynamoDB trigger parameter).

Range:

None

table_name

String

Parameter description:

Database table name (DynamoDB trigger parameter).

Range:

None

roma_app_id

String

Parameter description:

ID of the integration application to which the API belongs (APIG trigger parameter).

Range:

None

operations

Array of strings

Parameter description:

Custom operations (CTS trigger parameter).

CTS collects operation records of subscribed cloud resources. If you create a function with a CTS trigger, collected operation records of specified cloud services will be passed as a parameter to invoke the function.

Range:

None

collection_name

String

Parameter description:

Collection name (DDS trigger parameter).

Range:

None

db_name

String

Parameter description:

Database name (DDS trigger parameter).

Range:

None

db_password

String

Parameter description:

DDS database password (DDS trigger parameter).

Range:

None

db_user

String

Parameter description:

DDS database username (DDS trigger parameter).

Range:

None

instance_addrs

Array of strings

Parameter description:

DDS database instance address (DDS trigger parameter).

Range:

None

mode

String

Parameter description:

DDS database instance type (DDS trigger parameter).

Range

Sharding: cluster instance

ReplicaSet: replica set instance

Single: single node instance

batch_size

Integer

Parameter description:

Batch size: Maximum number of data records that can be processed by the function at a time. This parameter is mandatory for DIS, DDS, Kafka, RocketMQ, and RabbitMQ triggers.

Range

DDS trigger: Enter a value from 1 to 10,000.

DIS trigger: Enter a value from 1 to 10,000.

Kafka trigger: Enter a value from 1 to 1,000.

RabbitMQ trigger: Enter a value from 1 to 1,000.

RocketMQ trigger: Enter a value from 1 to 1,000.

  • DYNAMODB trigger: Enter a value from 1 to 1,000.

queue_id

String

Parameter description:

Queue ID (DMS trigger parameter).

Range:

None

consumer_group_id

String

Parameter description:

Consumer group ID (DMS trigger parameter).

Range:

None

polling_interval

Integer

Parameter description:

Pull period.

Range:

None

stream_name

String

Parameter description:

Stream name (DIS trigger parameter).

Range:

None

sharditerator_type

String

Parameter description:

Starting position (DIS/DynamoDB trigger parameter).

Range

  • TRIM_HORIZON: Data is read from the earliest valid record stored in the partition.

  • LATEST: Data is read from the latest record in the partition. This option ensures that the most recent data in the partition is read.

polling_unit

String

Parameter description:

Pull period unit (DIS trigger parameter).

Range

  • s: second.

ms: millisecond

max_fetch_bytes

Integer

Parameter description:

Max. fetch bytes (DIS trigger parameter).

Range:

None

is_serial

String

Parameter description:

Whether to process data in serial mode (DIS trigger parameter).

Range

  • true: Data is processed in serial mode. Data is obtained only after the previous data is processed.

  • false: Data is processed in parallel mode. Data is obtained as long as the pull period arrives.

log_group_id

String

Parameter description:

Log group ID (LTS trigger parameter).

Range:

None

log_topic_id

String

Parameter description:

Log stream ID (LTS trigger parameter).

Range:

None

bucket

String

Parameter description:

Bucket name (OBS trigger parameter). The name of the OBS bucket used as the event source cannot be the same as that of an existing bucket of the current user or another user. After being created, the bucket name cannot be modified.

Range:

None

prefix

String

Parameter description:

Prefix (OBS trigger parameter). Enter a prefix to limit notifications to objects whose names start with the matching characters.

Range:

None

suffix

String

Parameter description:

Suffix (OBS trigger parameter). Enter a suffix to limit notifications to objects whose names end with the matching characters.

Range:

None

events

Array of strings

Parameter description:

Trigger event (OBS trigger parameter).

Range

ObjectCreated: all kinds of object creation operations, including PUT, POST, COPY, and part assembling

Put: object upload using PUT

Post: object upload using POST

Copy: object copying using COPY

CompleteMultipartUpload: Assemble parts in a multipart upload.

ObjectRemoved: deleting objects

Delete: object deletion with a version ID specified

DeleteMarkerCreated: object deletion with no version ID specified

topic_urn

String

Parameter description:

Topic URN (SMN trigger parameter)

Range:

None

topic_ids

Array of strings

Parameter description:

The Kafka topic ID list (Kafka trigger parameter).

Range:

None

kafka_user

String

Parameter description:

Kafka account name (Kafka trigger parameter).

Range:

None

kafka_password

String

Parameter description:

Kafka password (Kafka trigger parameter).

Range:

None

kafka_connect_address

String

Parameter description:

Kafka instance connection address (Kafka trigger parameter).

Range:

None

kafka_ssl_enable

Boolean

Parameter description:

Whether to enable security authentication (Kafka trigger parameter).

Range:

None

access_password

String

Parameter description:

RabbitMQ account password (RabbitMQ trigger parameter).

Range:

None

access_user

String

Parameter description:

RabbitMQ username (RabbitMQ trigger parameter).

Range:

None

connect_address

String

Parameter description:

Instance IP address (RabbitMQ trigger parameter).

Range:

None

exchange_name

String

Parameter description:

Switch name (RabbitMQ trigger parameter).

Range:

None

vhost

String

Parameter description:

Virtual host (RabbitMQ trigger parameter).

Range:

None

ssl_enable

Boolean

Parameter description:

Whether to enable security authentication (RabbitMQ trigger parameter).

Range

  • true: This option will be enabled.

  • false: No

enable_acl

Boolean

Parameter description:

Whether to enable username and password authentication (RocketMQ trigger parameter).

Range

  • true: This option will be enabled.

false: no

access_key

String

Parameter description:

Connection username (RocketMQ trigger parameter). This parameter is mandatory when enable_acl is set to true.

Range:

None

secret_key

String

Parameter description:

Connection password (RocketMQ trigger parameter). This parameter is mandatory when enable_acl is set to true.

Range:

None

Table 7 ApigTriggerFuncInfo

Parameter

Type

Description

function_urn

String

Parameter description:

Function URN. For details, see the function model descriptions.

Range:

None

invocation_type

String

Parameter description:

Execution mode of a function.

Range

sync: synchronous execution

async: asynchronous execution

timeout

Integer

Parameter description:

Timeout allowed for APIG to request the FunctionGraph service. The unit is in millisecond. This parameter is mandatory for APIG triggers.

Range

1 to 60000 seconds

version

String

Parameter description:

Function version information.

Range:

None

Status code: 401

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 403

Table 9 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 500

Table 10 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

Obtaining the trigger list

GET /v2/{project_id}/fgs/triggers

Example Responses

Status code: 200

{
  "triggers" : [ {
    "trigger_id" : "f8cf27db-86ae-4542-a3c2-f0c98905xxxx",
    "trigger_type_code" : "TIMER",
    "trigger_status" : "ACTIVE",
    "event_data" : {
      "name" : "Timer-54f1",
      "schedule" : "3m",
      "schedule_type" : "Rate"
    },
    "last_updated_time" : "2022-11-09 16:37:24",
    "created_time" : "2022-11-09 16:37:24",
    "func_urn" : "urn:fss:{region}:09f7170b2c800f5a2fe2c00706fdxxxx:function:ldd:ecs-down:latest"
  } ],
  "next_marker" : 1,
  "total_count" : 1
}

Status Codes

Status Code

Description

200

OK

401

Unauthorized.

403

Forbidden.

500

Internal server error.

Error Codes

See Error Codes.