翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Health は、 をトランスポートHTTPSとして使用し、メッセージをシリアル化形式JSONとして使用するRESTfulウェブサービスです。アプリケーションコードは、 に直接 AWS Health リクエストを行うことができますAPI。REST API を直接使用する場合は、リクエストに署名して認証するために必要なコードを記述する必要があります。 AWS Health オペレーションとパラメータの詳細については、「 AWS Health APIリファレンス」を参照してください。
注記
AWS サポートSubscriptionRequiredException
エラーが発生します。
を使用して AWS SDKsAPI呼び出しを AWS Health RESTラップできるため、アプリケーションの開発が簡素化されます。 AWS 認証情報を指定すると、これらのライブラリが認証とリクエスト署名を処理します。
AWS Health には、イベントや影響を受けるエンティティを表示および検索するために AWS Management Console 使用できる の AWS Health Dashboard も用意されています。「AWS Health ダッシュボードの開始方法」を参照してください。
トピック
AWS Health API リクエストへの署名
または AWS Command Line Interface (AWS CLI) を使用して AWS SDKs にリクエストを行うと 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 リクエストへの署名」を参照してください。
次の表は、デフォルトの設定を示しています。
説明 | 署名リージョン | エンドポイント | プロトコル |
---|---|---|---|
アクティブ |
us-east-1 |
health.us-east-1.amazonaws.com |
HTTPS |
パッシブ |
us-east-2 |
health.us-east-2.amazonaws.com |
HTTPS |
グローバル |
us-east-1 注記これは、現在のアクティブなエンドポイントの署名リージョンです。 |
global.health.amazonaws.com |
HTTPS |
エンドポイントがアクティブなエンドポイントであるかどうかを確認するには、グローバルエンドポイント でDNS検索しCNAME、解決された名前から AWS リージョンを抽出します。
例 : グローバルエンドポイントでDNSの検索
次のコマンドは、global.health.amazonaws.com エンドポイントDNSの検索を完了します。次に、このコマンドは us-east-1 リージョンエンドポイントを返します。この出力は、どのエンドポイントを使用するかを示します AWS Health。
dig global.health.amazonaws.com | grep CNAME
global.health.amazonaws.com. 10 IN CNAME health.us-east-1.amazonaws.com
ヒント
アクティブエンドポイントとパッシブエンドポイントの両方が AWS Health データを返します。ただし、最新の AWS Health データは、アクティブなエンドポイントからのみ提供されます。パッシブなエンドポイントからのデータは、最終的にアクティブなエンドポイントと一致します。アクティブなエンドポイントが変更された場合は、ワークフローを再起動することをお勧めします。