調用CreateTrigger介面建立觸發器。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
要求標頭
該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。
請求文法
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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。