调用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"
}