翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS AppConfig エージェントを使用せずに設定データを取得する

から設定データを取得する推奨方法は、Amazon が開発および管理する AWS AppConfig エージェントを使用すること AWS AppConfig です。エージェントを使用すると、設定データをローカルにキャッシュし、データ AWS AppConfig プレーンサービスの更新を非同期的にポーリングできます。このキャッシュ/ポーリングプロセスにより、レイテンシーとコストを最小限に抑えながら、アプリケーションで設定データを常に利用できるようになります。エージェントを使用しない場合は、 AWS AppConfig データプレーンサービスから直接パブリック APIsを呼び出すことができます。

データプレーンサービスは、StartConfigurationSession と GetLatestConfiguration という 2 つの API アクションを使用します。データプレーンサービスは、 AWS AppConfig コントロールプレーンとは別のエンドポイントも使用します。

仕組み

データプレーンサービスを使用して AWS AppConfig APIs を直接呼び出すプロセスは次のとおりです。

アプリケーションは、最初に StartConfigurationSession API オペレーションを使用して設定セッションを確立確立することで、設定データを取得します。次に、セッションのクライアントは定期的に ‬GetLatestConfiguration を呼び出し、最新の利用可能なデータを確認して取得します。

StartConfigurationSession が呼び出されると、コードは次の情報を送信します。

レスポンスとして、 はセッションのクライアントに渡す InitialConfigurationToken AWS AppConfig を提供し、そのセッションGetLatestConfigurationを初めて呼び出すときに を使用します。

GetLatestConfiguration を呼び出すと、クライアントコードは最新の ConfigurationToken 値を送信し、応答を受信します。

（例) AWS AppConfig APIs を呼び出して設定を取得する

次の AWS CLI 例は、 AWS AppConfig Data StartConfigurationSessionおよび GetLatestConfiguration API オペレーションを使用して設定データを取得する方法を示しています。最初のコマンドは設定セッションを開始します。この呼び出しには、 AWS AppConfig アプリケーション、環境、および設定プロファイルの IDs (または名前) が含まれます。API は、設定データをフェッチするために使用される InitialConfigurationToken を返します。

aws appconfigdata start-configuration-session \
    --application-identifier application_name_or_ID \
    --environment-identifier environment_name_or_ID \
    --configuration-profile-identifier configuration_profile_name_or_ID 

システムから以下の形式の情報で応答します。

{
   "InitialConfigurationToken": initial configuration token
}

セッションを開始したら、設定データをフェッチするために、InitialConfigurationToken を使用して GetLatestConfiguration を呼び出します。設定データは、mydata.json ファイルに保存されます。

aws appconfigdata get-latest-configuration \
    --configuration-token initial configuration token mydata.json

GetLatestConfiguration への初回呼び出しでは、StartConfigurationSession から取得された ConfigurationToken を使用します。次の情報が返されます。

{
    "NextPollConfigurationToken" : next configuration token,
    "ContentType" : content type of configuration,
    "NextPollIntervalInSeconds" : 60
}  

それ以降の GetLatestConfiguration への呼び出しでは、前の応答から NextPollConfigurationToken を提供する必要があります。‬

aws appconfigdata get-latest-configuration \
    --configuration-token next configuration token mydata.json