AWS Health API を使用した AWS Health 他のシステムとの統合

AWS Health は、トランスポートとして HTTPS を使用し、メッセージのシリアル化形式として JSON を使用する RESTful ウェブサービスです。アプリケーションコードから直接、 AWS Health API にリクエストを行うことができます。この REST API を直接使用するときは、リクエストの署名と認証のためのコードを書く必要があります。 AWS Health オペレーションとパラメータの詳細については、 AWS Health API リファレンスを参照してください。

AWS SDKs を使用して REST API AWS Health コールをラップできるため、アプリケーション開発を簡素化できます。 AWS 認証情報を指定すると、これらのライブラリが認証とリクエストの署名を処理します。

AWS Health には、イベントや影響を受けるエンティティを表示および検索するために AWS Management Console 使用できる の AWS Health Dashboard も用意されています。「AWS Health ダッシュボードの開始方法」を参照してください。

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 ユーザーの認証情報を代わりに使用できます。詳細については、「IAM ユーザーガイド」の AWS 「アカウントのルートユーザーアクセスキーをロックする」を参照してください。

AWS SDKs または を使用しない場合は AWS CLI、リクエストを自分で署名する必要があります。 AWS 署名バージョン 4 を使用することをお勧めします。詳細については、『』のAWS 「 API リクエストの署名」を参照してくださいAWS 全般のリファレンス。

AWS Health API リクエストのエンドポイントの選択

AWS Health API は、マルチリージョンアプリケーションアーキテクチャに従い、アクティブ/パッシブ設定に 2 つのリージョンエンドポイントがあります。アクティブ/パッシブ DNS フェイルオーバーをサポートするために、 AWS Health は単一のグローバルエンドポイントを提供します。グローバルエンドポイントで DNS ルックアップを実行して、アクティブなエンドポイントと対応する署名 AWS リージョンを判断できます。これにより、コードで使用するエンドポイントがわかり、最新情報を取得できます AWS Health。

グローバルエンドポイントにリクエストを行うときは、ターゲットとするリージョンエンドポイント AWS へのアクセス認証情報を指定し、リージョンの署名を設定する必要があります。それ以外の場合は、認証が失敗することがあります。詳細については、「AWS Health API リクエストの署名」を参照してください。

IPv6-onlyリクエストの場合は、グローバルエンドポイントで 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