建立觸發器。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
fc:CreateTrigger |
create |
*全部資源
|
無 | 無 |
請求文法
POST /2021-04-06/services/{serviceName}/functions/{functionName}/triggers HTTP/1.1路徑參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| serviceName |
string |
是 |
服務的名稱。 |
demoService |
| functionName |
string |
是 |
函數的名稱。 |
demoFunction |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| body |
object |
否 |
觸發器的定義。 |
|
| invocationRole |
string |
否 |
事件來源（如 OSS）調用函數所需的角色。更多資訊，請參見觸發器簡介。 |
acs:ram::1234567890:role/fc-test |
| qualifier |
string |
否 |
服務的版本或別名。 |
LATEST |
| sourceArn |
string |
否 |
觸發事件源的 Aliyun Resource Name。對於定時、HTTP 和 EventBridge 類型的觸發器可忽略該參數，其它類型觸發器該參數為必填項。對於 EB 觸發器，若主動填寫該欄位，表示將 EB 側已存在資源關聯到該觸發器，注意，兩個不同 EB 觸發器不要配置同一個 sourceArn，否則觸發器的更新/刪除操作會相互影響 |
acs:oss:cn-shanghai:12345:mybucket |
| triggerConfig |
string |
是 |
觸發器配置，針對不同類型的觸發器，配置有所不同。具體格式請參考如下對應的資料結構：
|
{"events": ["oss:ObjectCreated:*"], "filter": {"key": {"prefix": "/prefix", "suffix": ".zip"}}} |
| triggerName |
string |
是 |
觸發器的名稱。要求只能包含字母、數字、底線(_)和短劃線(-)。不能以數字、短劃線(-)開頭，長度限制為 1~128 個字元。 |
oss_create_object_demo |
| triggerType |
string |
是 |
觸發器的類型。具體取值和觸發器類型對應關係如下所示：
枚舉值：
|
oss |
| description |
string |
否 |
觸發器的描述。 |
trigger for test |
| X-Fc-Account-Id |
string |
否 |
您的阿里雲帳號（主帳號）ID。 |
188077086902**** |
| X-Fc-Date |
string |
否 |
用戶端發起請求的時間。格式為EEE,d MMM yyyy HH:mm:ss GMT。 |
Wed, 11 May 2022 09:00:00 GMT |
| X-Fc-Trace-Id |
string |
否 |
自訂請求 ID。 |
my-test-trace-id |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
觸發器定義。 |
||
| createdTime |
string |
觸發器的建立時間。 |
2016-08-15T15:00:00.000+0000 |
| invocationRole |
string |
事件來源調用函數使用的 RAM 角色的 ARN。 |
acs:ram::1234567890:role/fc-test |
| lastModifiedTime |
string |
觸發器的上次修改時間。 |
016-08-15T17:00:00.000+0000 |
| qualifier |
string |
服務的版本。 |
LATEST |
| sourceArn |
string |
事件來源的 Aliyun Resource Name。 |
acs:oss:cn-shanghai:12345:mybucket |
| triggerConfig |
string |
觸發器配置，針對不同類型的觸發器，配置有所不同。 |
{"events": ["oss:ObjectCreated:*"], "filter": {"key": {"prefix": "/prefix", "suffix": ".zip"}}} |
| triggerName |
string |
觸發器的名稱。要求只能包含字母、數字、底線（_）和短劃線（-）。不能以數字、短劃線（-）開頭，長度限制為 1~128 個字元。 |
oss_create_object_trigger_demo |
| triggerType |
string |
觸發器的類型，例如 oss、log、tablestore、timer、http、cdn_events、mns_topic、eventbridge。 |
oss |
| description |
string |
觸發器的描述。 |
trigger for test |
| triggerId |
string |
觸發器的唯一 ID。 |
3e270f2f-cef2-421a-bc86-ff4e8088**** |
| domainName |
string |
網域名稱名稱，使用網域名稱名稱拼接上Function Compute網域名稱，可以採用 HTTP 協議調用到觸發器對應版本的函數。例如 |
demo-service-demo-function-jkhksh |
| urlInternet |
string |
公網網域名稱地址。在互連網可以通過 HTTP 協議或者 HTTPS 協議訪問 HTTP Trigger。 |
https://svc-func-xxxxxxxx.cn-hangzhou.fcapp.run |
| urlIntranet |
string |
私網網域名稱地址。在 VPC 可以通過 HTTP 協議或者 HTTPS 協議訪問 HTTP Trigger。 |
https://svc-func-xxxxxxxx.cn-hangzhou-vpc.fcapp.run |
樣本
正常返回樣本
JSON格式
{
"createdTime": "2016-08-15T15:00:00.000+0000",
"invocationRole": "acs:ram::1234567890:role/fc-test",
"lastModifiedTime": "016-08-15T17:00:00.000+0000",
"qualifier": "LATEST",
"sourceArn": "acs:oss:cn-shanghai:12345:mybucket",
"triggerConfig": "{\"events\": [\"oss:ObjectCreated:*\"], \"filter\": {\"key\": {\"prefix\": \"/prefix\", \"suffix\": \".zip\"}}}",
"triggerName": "oss_create_object_trigger_demo",
"triggerType": "oss",
"description": "trigger for test",
"triggerId": "3e270f2f-cef2-421a-bc86-ff4e8088****",
"domainName": "demo-service-demo-function-jkhksh",
"urlInternet": "https://svc-func-xxxxxxxx.cn-hangzhou.fcapp.run",
"urlIntranet": "https://svc-func-xxxxxxxx.cn-hangzhou-vpc.fcapp.run"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。