Use DescribeFCTrigger to query a Function Compute trigger - CDN - Alibaba Cloud - CDN

Queries the configuration of a specified Function Compute trigger, including its ARN, associated RAM role, event source, and event metadata.

Debugging

Debug

Run this operation directly in OpenAPI Explorer. OpenAPI Explorer calculates the request signature automatically and generates SDK code samples upon a successful call.

Authorization information

The following table lists the authorization details for this operation. Use the values in the Operation column in the Action element of a RAM policy to grant a RAM user or RAM role permission to call this operation.

Operation	Access level	Resource type	Condition key	Associated operation
cdn:DescribeFCTrigger	get	All Resources``	none	none

Request parameters

Parameter	Type	Required	Description	Example
TriggerARN	string	Yes	The ARN of the Function Compute trigger to query. Format: `acs:cdn:{RegionID}:{AccountID}:{Filter}`	acs:cdn:{RegionID}:{AccountID}:{Filter}

Response parameters

Parameter	Type	Description	Example
RequestId	string	The request ID.	EC046C5D-8CB4-4B6B-B7F8-B335E51EF90E
FCTrigger	object	The details of the Function Compute trigger.
TriggerARN	string	The ARN of the Function Compute trigger.	acs:fc:cn-beijing: 1234567890:services/FCTestService/functions/printEvent/triggers/testtrigger
RoleARN	string	The ARN of the Resource Access Management (RAM) role assigned to the trigger.	acs:ram:: 1234567890:role/aliyuncdneventnotificationrole
SourceArn	string	The ARN of the event source, specifying the resources and filters used for event listening.	acs:cdn:*:1234567890:domain/example.com
Notes	string	The notes for the Function Compute trigger.	test
EventMetaName	string	The name of the event.	LogFileCreated
EventMetaVersion	string	The version of the event.	1.0.0

SourceArn format

SourceArn uses the format acs:cdn:{RegionID}:{AccountID}:{Filter}.

Filter syntax

A filter follows the format {FilterName}/{FilterValue}. To specify multiple values for a single filter, separate the values with commas (,) and enclose them in braces ({}).

For the LogFileCreated event, FilterName is domain:

Single domain: domain/example.com — triggers Function Compute only for example.com.
Multiple domains: domain/{example.com,aliyun.com} — triggers Function Compute for both domains.

To apply multiple filters, separate them with forward slashes (/). Multiple filters are combined with AND logic:

acs:cdn:{RegionID}:{AccountID}:{Filter1}/{Filter2}/{Filter3}

Examples

Sample success responses

JSON format

{
  "RequestId": "EC046C5D-8CB4-4B6B-B7F8-B335E51EF90E",
  "FCTrigger": {
    "TriggerARN": "acs:fc:cn-beijing: 1234567890:services/FCTestService/functions/printEvent/triggers/testtrigger",
    "RoleARN": "acs:ram:: 1234567890:role/aliyuncdneventnotificationrole",
    "SourceArn": "acs:cdn:*:1234567890:domain/example.com",
    "Notes": "test",
    "EventMetaName": "LogFileCreated",
    "EventMetaVersion": "1.0.0"
  }
}

Error codes

HTTP status code	Error code	Error message
403	PermissionDeny	No permission to operate this FCTrigger.
404	NotFound.FCTrigger	FCTrigger not found.

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2024-12-18	API Description Update. The Error code has changed	View Change Details