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

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

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

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

重要

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

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

  • 根據 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閘道目標時，您可以將資料動態新增至傳送至目標的事件。如需詳細資訊，請參閱目標參數。

調用指標

如同所有目標， 會 EventBridge 重試一些失敗的叫用。對於 API Gateway， EventBridge 以 5xx 或 429 HTTP 狀態碼重試傳送的回應長達 24 小時，並呈指數方向關閉和抖動 。之後， 會在 Amazon 中 EventBridge 發佈FailedInvocations指標 CloudWatch。 EventBridge 不會重試其他 4xx HTTP錯誤。

逾時

EventBridge rule API Gateway 請求的最大用戶端執行逾時必須為 5 秒。如果 API Gateway 需要超過 5 秒才能回應，則會 EventBridge 逾時請求，然後重試。

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