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