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

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

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

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

对 AWS Health API 请求进行签名

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

Java 代码示例

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

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

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

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

AWS Health 为了支持主动-被动 DNS 故障转移， AWS Health 提供了一个全局端点。您可以在全局终端节点上执行 DNS 查找，以确定活动终端节点和相应的签名 AWS 区域。这可以帮助您知道要在代码中使用哪个端点，以便您可以从中获取最新信息 AWS Health。

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

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

下表列出了默认配置。

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

dig global.health.amazonaws.com | grep CNAME
global.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com