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

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

亚马逊EventBridgeAmazon API Gateway 的目标

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

重要

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

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

  • 根据以下条件调用 API Gateway 中托管的客户指定的 REST APIAmazon或第三方活动。

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

这些区域有:EventBridgeJSON 事件信息作为 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发布FailedInvocationsAmazon 中的指标CloudWatch. EventBridge不会重试其他 4xx HTTP 错误。

Timeout

EventBridgeAPI Gateway 请求的最长客户端执行超时时间必须为 5 秒。如果 API Gateway 需要 5 秒以上的时间才能做出响应,EventBridge超时请求然后重试