使用 Amazon Health API Amazon Health 与其他系统集成

Amazon Health 是一项 RESTful Web 服务，它使用 HTTPS 作为传输，使用 JSON 作为消息序列化格式。您的应用程序代码可以直接向 Amazon Health API 发送请求。在您直接使用 REST API 时，您必须编写必要的代码来对您的请求签名以及验证您的请求。有关 Amazon Health 操作和参数的更多信息，请参阅 Amazon Health API 参考。

您可以使用 Amazon SDKs 来封装 Amazon Health REST API 调用，这样可以简化应用程序开发。您可以指定您的 Amazon 凭据，这些库会为您处理身份验证和请求签名。

Amazon Health 还在中提供了一个 Amazon Health 控制面板 Amazon Web Services Management Console ，可用于查看和搜索事件和受影响的实体。请参阅 Amazon Health Dashboard 入门。

对 Amazon Health API 请求进行签名

当您使用 Amazon SDKs 或 Amazon Command Line Interface (Amazon CLI) 向发出请求时 Amazon，这些工具会自动使用您在配置工具时指定的访问密钥为您签署请求。例如，如果您在 适用于 Java 的 Amazon SDK 之前的高可用性终端节点演示中使用，则无需自己签署请求。

Java 代码示例

有关如何将 Amazon Health API 与一起使用的更多示例 适用于 Java 的 Amazon SDK，请参阅此示例代码。

当您提出请求时，我们强烈建议您不要使用 Amazon 根账户证书进行常规访问 Amazon Health。您可以使用 IAM 用户的凭证。有关更多信息，请参阅 IAM 用户指南中的锁定 Amazon 账户根用户访问密钥。

如果您不使用 Amazon SDKs 或 Amazon CLI，则必须自己签署请求。我们建议您使用 Amazon 签名版本 4。有关更多信息，请参阅中的签署 Amazon API 请求Amazon Web Services 一般参考。

为 Amazon Health API 请求选择终端节点

Amazon Health API 遵循多区域应用程序架构多区域应用程序架构，并且在主动-被动配置中具有两个区域端点。为了支持主动-被动 DNS 故障转移， Amazon Health 提供了一个全局端点。您可以在全局终端节点上执行 DNS 查找，以确定活动终端节点和相应的签名 Amazon 区域。这可以帮助您知道要在代码中使用哪个端点，以便您可以从中获取最新信息 Amazon Health。

当您向全球终端节点发出请求时，必须指定您对目标区域终端节点的 Amazon 访问凭证，并为您的区域配置签名。否则，您的身份验证可能会失败。有关更多信息，请参阅 对 Amazon Health API 请求进行签名。

对于 IPv6仅限请求的请求，我们建议在全局终端节点上执行 DNS 查找以确定处于活动状态的请求， Amazon Web Services 区域 然后调用该区域 IPv6 支持的双栈终端节点。

下表列出了默认配置。

要确定终端节点是否为活动终端节点，请在全局终端节点 CNAME 上进行 DNS 查找，然后从解析的名称中提取 Amazon 区域。

dig global.health.amazonaws.com.cn  | grep CNAME
global.health.amazonaws.com.cn. 10 IN CNAME health.cn-northwest-1.amazonaws.com.cn