Amazon EventBridge 针对 Amazon API Gateway 的目标 - Amazon EventBridge
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

Amazon EventBridge 针对 Amazon API Gateway 的目标

您可以使用 Amazon API Gateway 创建、发布、维护和监控 REST API。Amazon EventBridge 支持向 API Gateway REST 终端节点发送事件。当您将 API Gateway 终端节点指定为target,每个event发送到目标映射到发送到终端节点的请求。

重要

EventBridge 支持使用 API Gateway边缘优化区域性终端节点作为目标。要了解有关终端节点的更多信息,请参阅https://docs.amazonaws.cn/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html

您可以将 API Gateway 目标用于以下使用案例:

  • 调用在 API Gateway 中托管的客户指定的 REST API,基于Amazon或第三方事件中)。

  • 按计划定期调用终端节点。

EventBridge JSON 事件信息作为 HTTP 请求的正文发送到您的终端节点。您可以在目标的HttpParameters字段,如下所示:

  • PathParameterValues列出了顺序对应于终端节点 ARN 中的任何路径变量的值,例如"arn:aws:execute-api:us-east-1:112233445566:myapi/*/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 会发布一个FailedInvocations指 Amazon CloudWatch。EventBridge 不会重试其他 4xx HTTP 错误。

Timeout

EventBridge API Gateway 请求的最大客户端执行超时时间必须为 5 秒。如果 API Gateway 需要超过 5 秒的时间来响应,EventBridge 会超时请求,然后重试