步驟 6. 接收配置 - AWS AppConfig

若我們提供該指南英語版本的翻譯,在有任何牴觸的狀況下請以英文版本的指南為主。其透過機器翻譯提供翻譯。

步驟 6. 接收配置

您必須透過與 GetConfiguration API 動作整合,將用戶端設定為接收組態更新。您可以使用 AWS 開發套件進行整合。以下的 AWS CLI 命令示範如何接收組態。此呼叫包括 AWS AppConfig 應用程式、環境、組態描述檔和唯一用戶端識別碼的 ID。組態內容會儲存到輸出檔案名稱。

注意

以下命令中的 client-id 參數是使用者指定的唯一 ID,用來識別組態的用戶端。此 ID 可讓 AWS AppConfig 按照部署策略中所定義的間隔來部署組態。

aws appconfig get-configuration \ --application application_name_or_ID \ --environment environment_name_or_ID \ --configuration configuration_profile_name_or_ID \ --client-id client_ID \ output_filename

系統會以下列格式回應相關資訊。

{ "ConfigurationVersion":"configuration version", "ContentType":"content type" }
重要

注意以下關於 GetConfiguration API操作:

  • TheThethe GetConfiguration 響應包括 Content 顯示配置數據的部分。TheThethe Content 僅當系統發現新的或更新的配置數據時,纔會顯示部分。如果系統未找到新的或更新的配置數據,則 Content 未返回部分(Null)。

  • AWS AppConfig 使用 ClientConfigurationVersion 參數的數值來識別用戶端上的組態版本。如果您不在每次呼叫 GetConfiguration 時傳送 ClientConfigurationVersion,您的用戶端會收到目前的組態。每次用戶端收到組態時,都會向您收取費用。

  • 爲避免超額費用,我們建議您將 ClientConfigurationVersion 每次拜訪 GetConfiguration。此值必須保存在您的客戶端。後續呼叫 GetConfiguration 必須使用 ClientConfigurationVersion 參數來傳遞這個數值,如此處所示。

在後續輪詢組態更新期間傳送 ConfigurationVersionHTTP ETags 的概念類似。

aws appconfig get-configuration \ --application application_name_or_ID \ --environment environment_name_or_ID \ --configuration configuration_profile_name_or_ID \ --client-configuration-version previous_configuration_version_value \ --client-id client_ID \ output_filename
注意

建議您根據預算、組態部署的預期頻率,以及組態的目標數目,調整 GetConfiguration API 呼叫的輪詢頻率。