Amazon EventBridge 中規則的 Amazon API Gateway 目標 EventBridge - Amazon EventBridge
動態參數調用指標逾時

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon EventBridge 中規則的 Amazon API Gateway 目標 EventBridge

您可以使用 Amazon API Gateway 來建立、發佈、維護與監控 API。Amazon EventBridge 支援將事件傳送至 API Gateway 端點。當您指定 API Gateway 端點做為目標時，傳送至目標的每個事件都會映射至傳送至端點的請求。

重要

EventBridge 支援使用 API Gateway 邊緣最佳化和區域端點作為目標。目前不支援私人端點。若要進一步了解叢集端點，請參閱 https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html。

您可以針對下列使用案例使用 API Gateway 目標：

  • 根據 AWS 或第三方事件調用 API Gateway 中託管的客戶指定 API。

  • 按照排程定期調用端點。

EventBridge JSON 事件資訊會做為 HTTP 請求的主體傳送至您的端點。您可以在目標 HttpParameters 欄位中指定其他請求屬性，如下所示：

  • PathParameterValues 列出了與端點 ARN 中的任何路徑變量順序對應的值，例如 "arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"。

  • QueryStringParameters 代表 EventBridge 附加至調用端點的查詢字串參數。

  • HeaderParameters 定義了要新增至請求的 HTTP 標頭。

注意

基於安全性考量，不允許使用下列 HTTP 標頭金鑰：

  • 任何前綴為 X-Amz 或 X-Amzn

  • Authorization

  • Connection

  • Content-Encoding

  • Content-Length

  • Host

  • Max-Forwards

  • TE

  • Transfer-Encoding

  • Trailer

  • Upgrade

  • Via

  • WWW-Authenticate

  • X-Forwarded-For

動態參數

調用 API Gateway 目標時，您可以動態地將資料新增至傳送至目標的事件。如需詳細資訊，請參閱 目標參數。

調用指標

與所有目標一樣，EventBridge 會重試某些失敗的調用。對於 API Gateway，EventBridge 會重試使用 5xx 或 429 HTTP 狀態碼傳送的回應，最長可達 24 小時，並具有指數退回和抖動。之後，EventBridge 在 Amazon CloudWatch 中發布 FailedInvocations 指標。EventBridge 不會重試其他 4xx HTTP 錯誤。

逾時

EventBridge 規則 API Gateway 請求的用戶端執行逾時上限必須為 5 秒。如果 API Gateway 的回應時間超過 5 秒，則 EventBridge 會逾時請求，然後重試。

EventBridge 管道 API Gateway 請求的逾時上限為 29 秒，即 API Gateway 上限。