本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS Health 是一種 RESTful Web 服務，使用 HTTPS 做為傳輸，並使用 JSON 做為訊息序列化格式。您的應用程式程式碼能夠直接向 AWS Health API 發出請求。當您直接使用 REST API 時，您必須撰寫必要的程式碼來簽署和驗證您的請求。如需 AWS Health 操作和參數的詳細資訊，請參閱 AWS Health API 參考。
注意
您必須擁有來自 的業務、企業功能提升或企業支援計劃，AWS SupportSubscriptionRequiredException錯誤。
您可以使用 AWS SDKs來包裝 AWS Health REST API 呼叫，這可以簡化您的應用程式開發。您可以指定您的 AWS 登入資料，這些程式庫會為您處理身分驗證和請求簽署。
AWS Health 也在 中提供 AWS Health 儀表板 AWS Management Console ，供您用來檢視和搜尋事件和受影響的實體。請參閱 AWS Health 儀表板入門。
主題
簽署 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 Signature 第 4 版。如需詳細資訊，請參閱 中的簽署 AWS API 請求AWS 一般參考。
選擇 AWS Health API 請求的端點
AWS Health API 遵循多區域應用程式架構，並在主動-被動組態中有兩個區域端點。若要支援主動-被動 DNS 容錯移轉， AWS Health 提供單一的全域端點。您可以在全域端點上執行 DNS 查詢，以判斷作用中端點和對應的簽署 AWS 區域。這可協助您了解要在程式碼中使用的端點，以便從中取得最新資訊 AWS Health。
當您向 全域端點提出請求時，您必須將 AWS 存取憑證指定為目標區域端點，並為區域設定簽署。否則，您的身分驗證可能會失敗。如需詳細資訊，請參閱簽署 AWS Health API 請求。
對於IPv6-only的請求，我們建議您對全域端點執行 DNS 查詢，以判斷作用中， AWS 區域 然後呼叫該區域的 IPv6 支援的雙堆疊端點。
下表代表預設組態。
| 描述 | 簽署區域 | 端點 | 通訊協定 |
|---|---|---|---|
| 作用中 |
us-east-1 |
health.us-east-1.amazonaws.com （僅限 IPv4) health.us-east-1.api.aws （支援 IPv4 和 IPv6) |
HTTPS |
| 被動 |
us-east-2 |
health.us-east-2.amazonaws.com （僅限 IPv4) health.us-east-2.api.aws （支援 IPv4 和 IPv6) |
HTTPS |
| 全球服務 |
us-east-1 注意這是目前作用中端點的簽署區域。 |
global.health.amazonaws.com |
HTTPS |
若要判斷端點是否為作用中端點，請對全域端點 CNAME 執行 DNS 查詢，然後從解析的名稱擷取 AWS 區域。
範例 ：全域端點上的 DNS 查詢
下列命令會在 global.health.amazonaws.com 端點上完成 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 資料只能從作用中端點取得。來自被動端點的資料最終將與主動端點一致。建議您在作用中端點變更時重新啟動任何工作流程。
