All Products
Search
Document Center

CDN:AddFCTrigger

Last Updated:Jul 05, 2024

Adds a Function Compute trigger.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
TriggerARNstringYes

The trigger that corresponds to the Function Compute service.

acs:fc:cn-beijing: 1234567890:services/FCTestService/functions/printEvent/triggers/testtrigger
EventMetaNamestringYes

The name of the event.

LogFileCreated
EventMetaVersionstringYes

The version of the event.

1.0.0
SourceARNstringYes

The resources and filters for event listening.

acs:cdn:*:1234567890:domain/example.com
FunctionARNstringNo

The feature trigger.

acs:fc:1223455566666:123:services/myservice/functions/myfunction
RoleARNstringYes

The assigned Resource Access Management (RAM) role.

acs:ram:: 1234567890:role/aliyuncdneventnotificationrole
NotesstringYes

The remarks.

test

TriggerARN

TriggerARN format: acs:cdn:{RegionID}:{AccountID}:{Filter}.

  • Filter indicates the resource and filter in the format of {FilterName}/{FilterValue}. If you want to specify multiple values for FilterValue, separate the values with commas (,) and enclose them with braces ({}).
  • In this example, the LogFileCreated event supports a filter of which FilterName is set to domain. Function Compute can be triggered only by example.com if Filter is set to domain/example.com. Function Compute can be triggered by multiple domains if Filter is set to domain/{example.com,aliyundoc.com}.
  • Separate filters with forward slashes (/). The forward slashes indicate the AND logic. Format: acs:cdn:{RegionID}:{AccountID}:{Filter1}/{Filter2}/{Filter3}....

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

EC046C5D-8CB4-4B6B-B7F8-B335E51EF90

Examples

Sample success responses

JSONformat

{
  "RequestId": "EC046C5D-8CB4-4B6B-B7F8-B335E51EF90"
}

Error codes

HTTP status codeError codeError message
400NotFound.EventMetaEventMeta not found.
400Duplicated.FCTriggerFCTrigger has already existed.
400InvalidParameter.TriggerARNThe specified parameter TriggerARN is not valid.
400InvalidParameter.SourceARNThe specified parameter SourceARN is not valid.
400InvalidParameter.FunctionARNThe specified parameter FunctionARN is not valid.
400InvalidParameter.RoleARNThe specified parameter RoleARN is not valid.
403PermissionDenyNo permission to operate this FCTrigger.

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