使用PutTargets為事件規則建立或更新事件目標-事件匯流排-阿里雲 - EventBridge

在指定的規則下建立或更新事件目標。

介面說明

在指定的規則下建立或更新事件目標。

調試

您可以在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>	是	需要新增或更新的事件目標列表。更多資訊，請參見使用限制。
	array<object>	否	需要新增或更新的事件目標。
Id	string	是	自訂事件目標 Id。	Mlm123456JHd2RsRoKw
Type	string	是	事件目標類型。更多資訊，請參見事件目標參數。	acs.fc.function
Endpoint	string	否	投遞端點連結。	acs:fc:cn-hangzhou:123456789098****:services/guide.LATEST/functions/HelloFC
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）。	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
Network	string	否	無效信件佇列的網路類型。
VpcId	string	否	VPC ID。
VSwitchIds	string	否	虛擬交換器 ID。
SecurityGroupId	string	否	安全性群組 ID。
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}!
ConcurrentConfig	object	否	並發控制配置。
Concurrency	integer	否	並發量。	34

返回參數

名稱	類型	描述	樣本值
	object
Message	string	錯誤資訊。	The event rule not existed!
RequestId	string	阿里雲為該請求產生的唯一識別碼。	6FB52207-7621-5292-BDF2-A17E2E984160
Data	object	返回結果。
ErrorEntriesCount	integer	處理失敗的事件目標數量。取值說明如下：取值為 0：所有事件目標均正常處理。取值為除 0 以外的其他整數：處理失敗的事件目標個數。	0
ErrorEntries	array<object>	處理失敗的事件目標資訊。
	object	處理失敗的事件目標資訊。
ErrorMessage	string	錯誤詳細描述。	The id of event target is duplicate!
ErrorCode	string	錯誤碼。	EventRuleTargetIdDuplicate
EntryId	string	處理失敗的事件目標 Id。	Mlm123456JHd2RsRoKw
Code	string	介面返回碼： Success：表示成功。其它：表示錯誤碼。錯誤碼詳情，請參見錯誤碼。	Success
Success	boolean	操作成功返回 true。	true

樣本

正常返回樣本

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

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。