直接呼叫以擷取組態 APIs - AWS AppConfig

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

直接呼叫以擷取組態 APIs

您的應用程式會先使用 StartConfigurationSessionAPI操作建立組態工作階段，以擷取組態資料。然後，工作階段的用戶端會定期呼叫 GetLatestConfiguration，以檢查和擷取可用的最新資料。

呼叫 時StartConfigurationSession，您的程式碼會傳送下列資訊：

  • 工作階段追蹤之 AWS AppConfig 應用程式、環境和組態設定檔的識別符 （ID 或名稱）。

  • （選用） 工作階段用戶端在呼叫 之間必須等待的最短時間GetLatestConfiguration。

作為回應， AWS AppConfig 會提供 InitialConfigurationToken 給工作階段的用戶端，並在第一次GetLatestConfiguration呼叫該工作階段時使用。

重要

此權杖在第一次呼叫 時只能使用一次GetLatestConfiguration。每次後續呼叫 時，您必須在GetLatestConfiguration回應 （NextPollConfigurationToken） 中使用新的權杖GetLatestConfiguration。若要支援長輪詢使用案例，權杖的有效期最長為 24 小時。如果GetLatestConfiguration呼叫使用過期的權杖，系統會傳回 BadRequestException。

呼叫 時GetLatestConfiguration，您的用戶端程式碼會傳送其最近擁有和接收ConfigurationToken的值，以回應：

  • NextPollConfigurationToken：下次呼叫 時要使用ConfigurationToken的值GetLatestConfiguration。

  • NextPollIntervalInSeconds：用戶端下次呼叫 之前應該等待的持續時間GetLatestConfiguration。

  • 組態：工作階段所需的最新資料。如果用戶端已有最新版本的組態，則這可能是空的。

重要

記下以下重要資訊。

  • 每個應用程式、環境、組態設定檔和用戶端StartConfigurationSessionAPI只能呼叫 一次，以使用 服務建立工作階段。這通常在應用程式的啟動時或在第一次擷取組態之前完成。

  • 如果您的組態是使用 部署KmsKeyIdentifier，則接收組態的請求必須包含呼叫 的許可kms:Decrypt。如需詳細資訊，請參閱 AWS Key Management Service API參考 中的解密。

  • 先前用於擷取組態資料 API的操作GetConfiguration已棄用。GetConfiguration API 操作不支援加密組態。