调用CreateTrigger接口创建触发器。

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

POST /services/{serviceName}/functions/{functionName}/triggers

请求参数

名称 类型 位置 是否必选 示例值 描述
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 是 true

触发器配置，针对不同类型的触发器，配置有所不同。
triggerName String Body 是 trigger_name

触发器的名称。
triggerType String Body 是 oss

触发器的类型。触发器的类型包含

返回数据

名称 类型 示例值 描述
ETag String trigger_name

确保实际修改的触发器和实际修改的触发器是一致的。
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 true

触发器配置，针对不同类型的触发器，配置有所不同。
triggerName String trigger_name

触发器的名称。
triggerType String oss

触发器的类型。触发器的类型包含

示例

请求示例

POST /services/service_name/functions/function_name/triggers HTTP/1.1 
公共请求头
 {
	"functionName":"function_name",
	"serviceName":"service_name",
	"body":{
		"sourceArn":"acs:oss:cn-shanghai:12345:mybucket",
		"triggerConfig":"true",
		"triggerName":"trigger_name",
		"qualifier":"LATEST",
		"triggerType":"oss",
		"invocationRole":"acs:ram::198611****4430:role/aliyunosseventnotificationrole"
	}
}

正常返回示例

JSON 格式 

HTTP/1.1 200 OK
公共响应头
{
  "triggerName": "trigger_name",
  "description": "test_description",
  "triggerId": "b883122b-6f86-4889-bb69-1729a41***",
  "sourceArn": "acs:oss:cn-shanghai:12345:mybucket",
  "triggerType": "oss",
  "invocationRole": "acs:ram::198611****4430:role/aliyunosseventnotificationrole",
  "qualifier":LATEST,
  "triggerConfig": {
    "events": [
      "oss:ObjectCreated:*"
    ],
    "filter": {
      "key": {
        "prefix": "prefix_text",
        "suffix": ".zip"
      }
    }
  },
  "createdTime": "2020-04-08T01:48:21Z",
  "lastModifiedTime": "2020-04-08T01:48:21Z"
}