调用CreateTrigger接口创建触发器。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
POST /services/{serviceName}/functions/{functionName}/triggers HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
serviceName | String | Path | 是 | service_name |
服务的名称。 |
functionName | String | Path | 是 | function_name |
函数的名称。 |
Object | Body | 是 |
触发器的定义。 |
||
invocationRole | String | Body | 是 | acs:ram::198611****4430:role/aliyunosseventnotificationrole |
事件源如OSS调用函数所需的角色。更多信息,请参见触发器简介。 |
qualifier | String | Body | 否 | LATEST |
服务的版本或别名。 |
sourceArn | String | Body | 是 | acs:oss:cn-shanghai:12345:mybucket |
触发器事件源的ARN。 |
triggerConfig | String | Body | 是 | {"events": ["oss:ObjectCreated:*"], "filter": {"key": {"prefix": "/prefix", "suffix": ".zip"}}} |
触发器配置,针对不同类型的触发器,配置有所不同。 |
triggerName | String | Body | 是 | trigger_name |
触发器的名称。 |
triggerType | String | Body | 是 | oss |
触发器的类型。触发器的类型包含
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
ETag | String | 738136ea26b79cee660862cd7628**** |
确保实际修改的触发器和实际修改的触发器是一致的。 |
createdTime | String | 2016-08-15T15:00:00.000+0000 |
触发器的创建时间。 |
invocationRole | String | acs:ram::198611****4430:role/aliyunosseventnotificationrole |
事件源如OSS调用函数所需的角色。更多信息,请参见触发器简介。 |
lastModifiedTime | String | 2020-04-08T01:48:21Z |
触发器上一次被更新的时间。 |
qualifier | String | LATEST |
服务的版本。更多信息,请参见版本简介。 |
sourceArn | String | acs:oss:cn-shanghai:12345:mybucket |
触发器事件源的ARN。 |
triggerConfig | String | {"events": ["oss:ObjectCreated:*"], "filter": {"key": {"prefix": "/prefix", "suffix": ".zip"}}} |
触发器配置,针对不同类型的触发器,配置有所不同。 |
triggerName | String | trigger_name |
触发器的名称。 |
triggerType | String | oss |
触发器的类型。触发器的类型包含
|
示例
请求示例
POST /services/service_name/functions/function_name/triggers HTTP/1.1
Host:fc-ram.aliyuncs.com
Content-Type:application/json
{
"invocationRole" : "acs:ram::198611****4430:role/aliyunosseventnotificationrole",
"qualifier" : "LATEST",
"sourceArn" : "acs:oss:cn-shanghai:12345:mybucket",
"triggerConfig" : "{\"events\": [\"oss:ObjectCreated:*\"], \"filter\": {\"key\": {\"prefix\": \"/prefix\", \"suffix\": \".zip\"}}}",
"triggerName" : "trigger_name",
"triggerType" : "oss"
}
正常返回示例
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"createdTime" : "2016-08-15T15:00:00.000+0000",
"invocationRole" : "acs:ram::198611****4430:role/aliyunosseventnotificationrole",
"lastModifiedTime" : "2020-04-08T01:48:21Z",
"qualifier" : "LATEST",
"sourceArn" : "acs:oss:cn-shanghai:12345:mybucket",
"triggerConfig" : "{\"events\": [\"oss:ObjectCreated:*\"], \"filter\": {\"key\": {\"prefix\": \"/prefix\", \"suffix\": \".zip\"}}}",
"triggerName" : "trigger_name",
"triggerType" : "oss"
}