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
| 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 |
| 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
| 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
| Parameter | Type | Description |
|---|---|---|
| triggers | Array of ListTriggerResult objects | Trigger list. |
| next_marker | Long | Next query location. |
| total_count | Long | Total number of triggers. |
| Parameter | Type | Description |
|---|---|---|
| trigger_id | String | Trigger ID. |
| trigger_type_code | String | Definition Trigger type code. Range |
| trigger_status | String | Trigger status. |
| 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. |
| 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
|
| 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 |
| 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 |
| 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. |
| 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 |
| polling_unit | String | Parameter description: Pull period unit (DIS trigger parameter). Range 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 |
| 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 |
| enable_acl | Boolean | Parameter description: Whether to enable username and password authentication (RocketMQ trigger parameter). Range 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 |
| 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
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code. |
| error_msg | String | Error message. |
Status code: 403
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code. |
| error_msg | String | Error message. |
Status code: 500
| 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.
What is your overall rating for this page?
Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot