在指定的規則下創建或更新事件目標。
接口說明
在指定的規則下創建或更新事件目標。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| eventbridge:PutTargets | update | *Rule acs:eventbridge:{#regionId}:{#accountId}:eventbus/{#EventBusName}/rule/{#RuleName} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| EventBusName | string | 是 | 事件總線的名稱。 | eventTest |
| RuleName | string | 是 | 事件規則的名稱。 | ssr-send-to-vendor-test01 |
| Targets | array<object> | 是 | 需要新增或更新的事件目標列表。更多信息，請參見使用限制。 | |
| object | 是 | 需要新增或更新的事件目標。 | ||
| Id | string | 是 | 自定義事件目標 Id。 | Mlm123456JHd2RsRoKw |
| Type | string | 是 | 事件目標類型。更多信息，請參見事件目標參數。 | acs.fc.function |
| Endpoint | string | 否 | 投遞端點鏈接。 | acs:fc:cn-hangzhou:123456789098****:services/guide.LATEST/functions/HelloFC |
| PushRetryStrategy | string | 否 | 推送重試策略。取值說明如下：
| BACKOFFRETRY |
| DeadLetterQueue | object | 否 | 死信隊列。未處理或者超過重試次數的事件會被寫入死信隊列。當前死信隊列支持的隊列類型有消息隊列 RocketMQ 版、輕量消息隊列（原 MNS）、消息隊列 Kafka 版和 EventBridge 事件總線。 | |
| Arn | string | 否 | 死信隊列的 Arn，未處理或超過重試次數的事件會被寫入死信隊列。 | 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 |
| ParamList | array<object> | 否 | 事件目標的參數。 | |
| object | 否 | 事件目標的參數。 | ||
| ResourceKey | string | 否 | 事件目標的資源參數。更多信息，請參見事件目標參數。 | body |
| Form | string | 否 | 事件目標參數的格式。更多信息，請參見事件目標參數。 | TEMPLATE |
| Value | string | 否 | 事件目標參數的值。 | {\"key\"=\"value\"} |
| Template | string | 否 | 事件目標參數模板樣式。 | The value of ${key} is ${value}! |
| ConcurrentConfig | object | 否 | 并發控制配置。 | |
| Concurrency | long | 否 | 并發量。 | 34 |
返回參數
示例
正常返回示例
JSON格式
{
"Message": "The event rule not existed!",
"RequestId": "6FB52207-7621-5292-BDF2-A17E2E984160\n",
"Data": {
"ErrorEntriesCount": 0,
"ErrorEntries": [
{
"ErrorMessage": "The id of event target is duplicate!",
"ErrorCode": "EventRuleTargetIdDuplicate",
"EntryId": "Mlm123456JHd2RsRoKw"
}
]
},
"Code": "Success",
"Success": true
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 |
|---|---|---|
| 403 | ServiceNotEnable | Service not enable |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-09-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |