第 6 步：接收配置 - AmazonAppConfig
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

第 6 步：接收配置

您必须将客户端配置为与 GetConfiguration API 操作集成以接收配置更新。您可以使用集成Amazon开发工具包。以下AmazonCLI 命令演示如何接收配置。此调用包括AmazonAppConfig 应用程序、环境和配置文件以及唯一的客户端 ID。配置内容将保存到输出文件名中。

注意

以下命令中的 client-id 参数是用户指定的唯一 ID，用于标识配置的客户端。此 ID 启用AmazonAppConfig 按部署策略中定义的时间间隔部署配置。 

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"
}
重要

请注意有关GetConfigurationAPI 操作：

  • 这些区域有：GetConfiguration响应包括的Content部分，显示配置数据。这些区域有：Content部分仅在系统找到新的或更新的配置数据时才会显示。如果系统找不到新的或更新的配置数据，则Content部分不返回 (Null)。

  • AmazonAppConfig 使用ClientConfigurationVersion参数以标识客户端上的配置版本。如果您没有在每次调用 GetConfiguration 时发送 ClientConfigurationVersion，则您的客户端会收到当前配置。您的客户端每次收到配置时，您都需要付费。

  • 为避免额外费用，我们建议您在每次调用 GetConfiguration 时都包含 ClientConfigurationVersion 值。此值必须保存在您的客户端上。对 GetConfiguration 的后续调用必须通过使用 ClientConfigurationVersion 参数传递此值，如下所示。

在随后的配置更新轮询期间发送 ConfigurationVersion 类似于 HTTP ETag 概念。 

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 调用的轮询频率。