本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# API 目的地作为亚马逊的目标 EventBridge
EventBridge *API 目标*是 HTTPS 端点，您可以将其作为事件总线规则或管道的目标进行调用，类似于调用 AWS 服务或资源作为目标的方式。使用 API 目标，您可以使用 API 调用在 AWS 服务、集成软件即服务 (SaaS) 应用程序以及公共或私有应用程序之间路由[事件](eb-events.md)。
当您将 API 目标指定为规则或管道目标时，会为任何与规则或管道中指定的[事件模式](eb-event-patterns.md)相匹配的事件 EventBridge 调用 HTTPS 端点，然后随请求传送事件信息。使用 EventBridge，您可以对请求使用除 CONNECT 和 TRACE 之外的任何 HTTP 方法。最常用的 HTTP 方法是 PUT 和 POST。
您也可以使用输入转换器，将事件自定义为特定 HTTP 端点参数的参数。有关更多信息，请参阅 [亚马逊 EventBridge 输入转换](eb-transform-target-input.md)。
EventBridge API 目标使用*连接*来定义授权方法、凭据和网络连接， EventBridge 以便在连接到给定 HTTPS 端点时使用。连接支持公共连接和私有连接 APIs。有关更多信息，请参阅 [Connections](eb-target-connection.md)。
**注意**
EventBridge 当使用私有时，API 目标目前仅支持带有公开信任证书的 HTTPS 终端节点的公共域名 APIs。API 目标不支持双向 TLS（mTLS）。
**重要**
EventBridge 向 API 目标端点发出的请求的最大客户端执行超时时间必须为 5 秒。如果目标端点的响应时间超过 5 秒， EventBridge 则请求超时。 EventBridge 重试会将请求超时到重试策略上配置的最大值。
对于事件总线，默认情况下，上限为 24 小时和 185 次。
对于管道，重试取决于管道源类型及其配置。 EventBridge 将重试，直到事件从源端到期，或者已达到配置的最大事件时限或重试尝试次数。
达到重试次数上限后，会将事件发送到[死信队列](eb-rule-dlq.md)（如有）。否则，该事件将被丢弃。
以下视频演示了 API 目标的用法：
## API 目标的服务相关角色
当您为 API 目标创建连接时，服务相关角色[AmazonEventBridgeApiDestinationsServiceRolePolicy](eb-use-identity-based.md#api-destination-slr-policy)将添加到您的账户。 EventBridge 使用此服务相关角色在 Secrets Manager 中创建和存储密钥。要向服务相关角色授予必要的权限，请将**AmazonEventBridgeApiDestinationsServiceRolePolicy**策略 EventBridge附加到该角色。该策略授予的权限，仅限于角色与连接密钥交互所必需的权限，不包括其他权限。该角色只能与您账户中的连接进行交互，以管理密钥。
有关服务相关角色的更多信息，请参见 *IAM 用户指南*中的[使用服务相关角色](https://docs.aws.amazon.com//IAM/latest/UserGuide/using-service-linked-roles.html)。
## 向 API 目标发送的请求中的标头
以下部分详细介绍如何 EventBridge 处理发往 API 目标的请求中的 HTTP 标头。
### 向 API 目标发送的请求中包含的标头
除了为用于 API 目标的连接定义的授权标头外，每个请求中 EventBridge 还包括以下标头。
| 标头键 | 标头值 |
| --- | --- |
| 用户代理 | Amazon/EventBridge/ApiDestinations |
| Content-Type | 如果未指定自定义 “内容类型” 值，则 EventBridge 包括以下默认值作为 “内容类型”：
application/json; charset=utf-8 |
| Range | bytes=0-1048575 |
| Accept-Encoding | gzip,deflate |
| Connection | 关闭 |
| 内容长度 | 表示发送到接收方的实体正文的大小（以字节为单位）的实体标头。 |
| 主机 | 一个请求标头，指定发送请求的服务器的主机和端口号。 |
### 向 API 目标发送的请求中无法覆盖的标头
EventBridge 不允许您覆盖以下标题：
+ 用户代理
+ Range
### 从 API 目标请求中 EventBridge 移除标头
EventBridge 删除所有 API 目标请求的以下标头：
+ A-IM
+ Accept-Charset
+ Accept-Datetime
+ Accept-Encoding
+ Cache-Control
+ Connection
+ Content-Encoding
+ 内容长度
+ 内容-MD5
+ 日期
+ Expect
+ Forwarded
+ From
+ 主机
+ HTTP2-设置
+ If-Match
+ If-Modified-Since
+ If-None-Match
+ If-Range
+ If-Unmodified-Since
+ Max-Forwards
+ Origin
+ Pragma
+ Proxy-Authorization
+ Range
+ Referer
+ TE
+ Trailer
+ Transfer-Encoding
+ 用户代理
+ Upgrade
+ Via
+ Warning
## API 目标错误代码
当 EventBridge 尝试将事件传送到 API 目标时出现错误时， EventBridge会执行以下操作：
+ 重试与错误代码 `401`、`407`、`409`、`429`、和 `5xx` 关联的事件。
+ 不重试与错误代码 `1xx`、`2xx`、`3xx`、和 `4xx`（上述错误代码除外）关联的事件。
EventBridge API 目的地会读取标准的 HTTP 响应标头，`Retry-After`以了解在发出后续请求之前需要等待多长时间。对于事件总线，在定义的重试策略和`Retry-After`标头之间 EventBridge选择更保守的值。如果`Retry-After`值为负，则 EventBridge停止重试该事件的传送。
## 调用率如何影响事件传送
如果将每秒调用速率设置为远低于生成的调用数量的值，则可能无法在 24 小时的重试时间内传送此事件。例如，如果您将调用速率设置为每秒 10 次调用，但每秒会生成数千个事件，则很快就会有超过 24 小时的待传送事件积压。为确保不会丢失任何事件，请设置一个死信队列，将调用失败的事件发送到该队列，以便日后可以处理这些事件。有关更多信息，请参阅 [使用死信队列处理中未传送的事件 EventBridge](eb-rule-dlq.md)。
## 区域可用性
以下 AWS 区域支持公有 HTTPS 终端节点的 API 目标：
+ 美国东部（弗吉尼亚州北部）
+ 美国东部（俄亥俄州）
+ 美国西部（北加利福尼亚）
+ 美国西部（俄勒冈州）
+ 非洲（开普敦）
+ 亚太地区（香港）
+ 亚太地区（东京）
+ 亚太地区（首尔）
+ 亚太地区（大阪）
+ 亚太地区（孟买）
+ 亚太地区（海得拉巴）
+ 亚太地区（新加坡）
+ 亚太地区（悉尼）
+ 亚太地区（雅加达）
+ 加拿大（中部）
+ 中国（北京）
+ 中国（宁夏）
+ 欧洲地区（法兰克福）
+ 欧洲（苏黎世）
+ 欧洲地区（斯德哥尔摩）
+ 欧洲地区（米兰）
+ 欧洲（西班牙）
+ 欧洲地区（爱尔兰）
+ 欧洲地区（伦敦）
+ Europe (Paris)
+ 中东（阿联酋）：
+ 中东（巴林）
+ 南美洲（圣保罗）