翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を直接呼び出して設定を取得する APIs
アプリケーションは、まず StartConfigurationSessionAPIオペレーションを使用して設定セッションを確立することで、設定データを取得します。その後、セッションのクライアントは を定期的に呼び出しGetLatestConfigurationて、利用可能な最新のデータをチェックして取得します。
StartConfigurationSession
が呼び出されると、コードは次の情報を送信します。
-
セッションが追跡する AWS AppConfig アプリケーション、環境、および設定プロファイルの識別子 (ID または名前)。
-
(オプショナル) セッションクライアントが
GetLatestConfiguration
を呼び出すまでに待機しなければならない最短時間
これに応じて、 はセッション AWS AppConfig のクライアントに InitialConfigurationToken
を渡して、GetLatestConfiguration
そのセッションを初めて呼び出すときに使用します。
重要
このトークンは、GetLatestConfiguration
の最初の呼び出し時に1回だけ使用する必要があります。以降の GetLatestConfiguration
への呼び出しでは、GetLatestConfiguration
応答 NextPollConfigurationToken
で新しいトークンを使用する必要があります。トークンは、ロングポーリングのユースケースをサポートするため、最大 24 時間有効です。GetLatestConfiguration
コールで期限切れのトークンが使用されると、システムから返されます BadRequestException
。
GetLatestConfiguration
を呼び出すと、クライアントコードは最新の ConfigurationToken
値を送信し、応答を受信します。
-
NextPollConfigurationToken
:次回のGetLatestConfiguration
への次の呼び出しで使用するConfigurationToken
値。 -
NextPollIntervalInSeconds
:クライアントが次にGetLatestConfiguration
を呼び出すまで待機する時間。 -
設定:セッション用の最新データ。クライアントにすでに最新バージョンの設定がある場合は、この値は空になる可能性があります。
重要
次の重要な情報に注意してください。
-
サービスとのセッションを確立するには、アプリケーション、環境、設定プロファイル、クライアントごとに を 1 回だけ呼び出すStartConfigurationSessionAPI必要があります。これは、通常、アプリケーションの起動時または設定の初回取得の直前に行われます。
-
KmsKeyIdentifier
を使用して設定をデプロイする場合、設定を受け取るリクエストにはkms:Decrypt
レスポンス権限が含まれている必要があります。詳細については、「 AWS Key Management Service APIリファレンス」の「Decrypt」を参照してください。 -
設定データ の取得にAPI以前使用されていたオペレーション
GetConfiguration
は廃止されました。GetConfiguration
API オペレーションは、暗号化された設定をサポートしていません。