創建一個事件規則。
接口說明
創建一個事件規則。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
EventBusName | string | 是 | 事件總線名稱。 | MyEventBus |
Description | string | 否 | 事件總線的描述 | MNS的過濾規則 |
RuleName | string | 是 | 事件規則的名稱 | MNSRule |
Status | string | 否 | 規則的狀態。取值說明如下: ENABLE:規則已啟用。規則默認狀態。 DISABLE:規則已禁用。 | ENABLE |
FilterPattern | string | 是 | 事件模式,JSON 格式。取值說明如下: stringEqual 模式。 stringExpression 模式 。 每個 field 最多 5 個 expression(map 結構)。 每個 field 最多 5 個 expression(map 結構)。 | {\"source\": [{\"prefix\": \"acs.\"}],\"type\": [{\"prefix\":\"oss:ObjectReplication\"}],\"subject\":[{\"prefix\":\"acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/\", \"suffix\":\".txt\"}]} |
EventTargets | array<object> | 是 | 事件目標列表。 | |
object | 是 | 事件目標。 | ||
Id | string | 是 | 自定義事件目標 Id。 | Mlm123456JHd2RsRoKw |
Type | string | 是 | 事件目標類型。更多信息,請參見事件目標參數。 | acs.mns.queue |
Endpoint | string | 否 | 投遞端點鏈接。 | acs:mns:cn-hangzhou:123456789098****:queues/myqueue |
PushRetryStrategy | string | 否 | 推送重試策略。取值說明如下: BACKOFF_RETRY:退避重試策略。重試 3 次,每次重試的間隔時間是 10 秒到 20 秒之間的隨機值。 EXPONENTIAL_DECAY_RETRY:指數衰減重試。重試 176 次,每次重試的間隔時間指數遞增至 512 秒,總計重試時間為 1 天;每次重試的具體間隔為:1,2,4,8,16,32,64,128,256,512,512...512 秒(共 167 個 512)。 | BACKOFF_RETRY |
DeadLetterQueue | object | 否 | 死信隊列。未處理或者超過重試次數的事件會被寫入死信隊列。當前死信隊列支持的隊列類型有消息隊列 RocketMQ 版、消息服務 MNS、消息隊列 Kafka 版和 EventBridge 事件總線。 | |
Arn | string | 否 | 死信隊列的 Arn,未處理或超過重試次數的事件會被寫入死信隊列。支持消息服務 MNS 和消息隊列 RocketMQ 版。 | acs:mns:cn-hangzhou:123456789098****:/queues/deadletterqueue 或 acs:mq:cn-hangzhou:123456789098****:/instances/MQ_INST_123456789098****_BX8QbBPL/topic/deadlettertopic 或 acs:alikafka:cn-hangzhou:123456789098****:instance/alikafka_post-cn-123456/topic/deadlettertopic 或 acs:eventbridge:cn-hangzhou:123456789098****:eventbus/deadletterbus |
ErrorsTolerance | string | 否 | 容錯策略。取值說明如下: ALL:允許容錯。允許異常容錯,當異常發生時不會阻塞執行,超過重試策略后會根據配置將消息投遞至死信隊列或直接丟棄。 NONE:禁止容錯。不允許容錯,當異常發生并超過重試策略配置時會阻塞執行。 | ALL |
ParamList | array<object> | 否 | 事件目標的參數。 | |
object | 否 | 事件目標的參數。 | ||
ResourceKey | string | 否 | 事件目標的資源參數。更多信息,請參見使用限制。 | body |
Form | string | 否 | 事件目標參數的格式。更多信息,請參見使用限制。 | TEMPLATE |
Value | string | 否 | 事件目標參數的值。 | {\"key\"=\"value\"} |
Template | string | 否 | 事件目標參數模板樣式。 | The value of ${key} is ${value}! |
請求示例
POST /openapi/createRule HTTP/1.1 Host: 123456789098****.eventbridge.cn-hangzhou.aliyuncs.com Date: Sat, 18 Apr 2020 05:30:41 GMT x-eventbridge-version: 2020-04-01 Authorization: acs vZ3VL0SuJdHi****:Jo2PbT******azYAYoYslKLvWzg= Content-Type: application/json;charset=UTF-8 Content-Length: 26
{ "EventBusName":"default", "RuleName":"MNSRule", "Description":"MNS 的過濾規則", "Status":"ENABLE", "filterPattern":"{"source": [{"prefix": "acs."}],"type": [{"prefix":"oss:ObjectReplication"}],"subject":[{"prefix":"acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/", "suffix":".txt"}]}", "Targets":[ { "Id":"1", "Type":"acs.mns.queue", "Endpoint":"acs:mns:cn-hangzhou:123456789098****:queues/myqueue", "PushRetryStrategy":"BACKOFF_RETRY", "DeadLetterQueue":{ "Arn":"acs:mns:cn-hangzhou:123456789098****:/queues/rule-deadletterqueue" }, "ParamList":[ { "resourceKey":"queue", "form":"CONSTANT", "value":"myqueue" }, { "resourceKey":"body", "form":"TEMPLATE", "value":"{"key"="value"}", "template":"The value of ${key} is ${value}!" } ] } ] }
返回參數
示例
正常返回示例
JSON
格式
{
"Message": "Remote error. requestId: [xxxx], error code: [xxx], message: [The target in event rule is invalid! Endpoint is xxx",
"RequestId": "1AD6D598-7506-5D2C-81EA-30E3241A903A",
"Data": {
"RuleARN": "acs:eventbridge:cn-hangzhou:123456789098****:eventbus/default/rule/MNSRule"
},
"Code": "Success",
"Success": true
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 |
---|---|---|
403 | ServiceNotEnable | Service not enable |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-09-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |