本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用 AWS Health 与其他系统集成 AWS Health API
AWS Health 是一项HTTPS用作传输格式和JSON消息序列化格式的 RESTful Web 服务。您的应用程序代码可以直接向发出请求 AWS Health API。RESTAPI直接使用时，必须编写必要的代码来签署和验证您的请求。有关 AWS Health 操作和参数的更多信息，请参阅参AWS Health API考。
注意
您必须拥有商业、企业入口或企业支持计划AWS 支持SubscriptionRequiredException错误消息。 AWS Health API
您可以使用 AWS SDKs来封装 AWS Health RESTAPI调用，这样可以简化应用程序开发。您可以指定您的 AWS 凭据，这些库会为您处理身份验证和请求签名。
AWS Health 还在中提供了一个 AWS Health 控制面板 AWS Management Console ，可用于查看和搜索事件和受影响的实体。请参阅 AWS Health Dashboard 入门。
主题
签署 AWS Health API请求
当您使用 AWS SDKs或 AWS Command Line Interface (AWS CLI) 向发出请求时 AWS，这些工具会自动使用您在配置工具时指定的访问密钥为您签署请求。例如，如果您在 AWS SDK for Java 之前的高可用性终端节点演示中使用，则无需自己签署请求。
Java 代码示例
有关如何 AWS Health API与一起使用的更多示例 AWS SDK for Java，请参阅此示例代码。
当您提出请求时，我们强烈建议您不要使用 AWS 根账户证书进行常规访问 AWS Health。您可以为IAM用户使用凭证。有关更多信息，请参阅《用户指南》中的 “锁定您的 AWS 账户 root IAM 用户访问密钥”。
如果您不使用 AWS SDKs或 AWS CLI，则必须自己签署请求。我们建议您使用 AWS 签名版本 4。有关更多信息，请参阅中的签署 AWS API请求AWS 一般参考。
为 AWS Health API请求选择终端节点
AWS Health API为了支持主动-被动DNS故障转移， AWS Health 提供了一个全局端点。您可以在全局终端节点上执行DNS查找，以确定活动终端节点和相应的签名 AWS 区域。这可以帮助您知道要在代码中使用哪个端点，以便您可以从中获取最新信息 AWS Health。
当您向全球终端节点发出请求时，必须指定您对目标区域终端节点的 AWS 访问凭证，并为您的区域配置签名。否则，您的身份验证可能会失败。有关更多信息，请参阅 签署 AWS Health API请求。
下表列出了默认配置。
| 描述 | 签名区域 | 终端节点 | 协议 |
|---|---|---|---|
| 活跃 |
us-east-1 |
health.us-east-1.amazonaws.com |
HTTPS |
| Passive |
us-east-2 |
health.us-east-2.amazonaws.com |
HTTPS |
| Global |
us-east-1 注意这是当前主动端点的签名区域。 |
global.health.amazonaws.com |
HTTPS |
要确定终端节点是否为活动终端节点，请在全局终端节点上进行DNS查找CNAME，然后从已解析的名称中提取 AWS 区域。
例 : 在全局端点上DNS查找
然后，该命令返回 us-east-1 区域端点。此输出告诉您应该使用哪个端点 AWS Health。
dig global.health.amazonaws.com | grep CNAMEglobal.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
提示
主动端点和被动端点都返回 AWS Health 数据。但是，最新 AWS Health 数据只能从主动端点获得。来自被动端点的数据最终将与主动端点保持一致。我们建议您在主动端点发生变化时重新启动所有工作流程。
