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

如果我们为英文版本指南提供翻译，那么如果存在任何冲突，将以英文版本指南为准。在提供翻译时使用机器翻译。

步骤 6. 接收配置

您必须将客户端配置为与 GetConfiguration API 操作集成以接收配置更新。您可以使用 AWS 开发工具包进行集成。以下 AWS CLI 命令说明了如何接收配置。该调用包括 AWS AppConfig 应用程序、环境和配置文件的 ID 以及唯一的客户端 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 参数传递此值，如下所示。

在随后的配置更新轮询期间发送 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 调用的轮询频率。