第 6 步:检索配置 - Amazon AppConfig
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

第 6 步:检索配置

您的应用程序首先使用StartConfiguration会话API 操作。然后你的会话的客户定期打电话GetLatest配置以检查和检索可用的最新数据。

打电话时StartConfigurationSession,代码发送以下信息:

  • 的标识符(ID 或名称)Amazon AppConfig会话跟踪的应用程序、环境和配置文件。

  • (可选)会话客户端在呼叫之间必须等待的最短时间。GetLatestConfiguration.

作为回应,Amazon AppConfig提供InitialConfigurationToken交给会话的客户端并在第一次调用时使用GetLatestConfiguration对于那个会议。

重要

这个令牌只能在你的第一次通话中使用一次GetLatestConfiguration. 您必须在中使用新令牌GetLatestConfiguration响应 (NextPollConfigurationToken) 在接下来的每次电话中GetLatestConfiguration.

打电话时GetLatestConfiguration,你的客户端代码发送最新的ConfigurationToken它拥有并在响应中获得的价值:

  • NextPollConfigurationToken: 该ConfigurationToken下次调用时要使用的值GetLatestConfiguration.

  • NextPollIntervalInSeconds:客户在下次打电话之前应等待的持续时间GetLatestConfiguration. 此持续时间可能随会话的过程而有所不同,因此应该使用它而不是在StartConfigurationSession调用。

  • 配置:用于会话的最新数据。如果客户端已经有最新版本的配置,则可能为空。

重要

请注意以下重要信息。

  • 这些区域有:StartConfiguration会话每个应用程序、环境、配置配置文件和客户端只能调用一次 API,以建立与服务的会话。这通常是在应用程序启动时或在首次检索配置之前完成的。

  • 这些区域有:InitialConfigurationTokenNextPollConfigurationToken24 小时后过期。如果GetLatestConfiguration调用使用过期的令牌,系统返回BadRequestException.

检索配置示例

以下Amazon CLI示例演示了如何使用Amazon AppConfig数据StartConfigurationSessionGetLatestConfigurationAPI 操作。第一个命令启动配置会话。此调用包括的 ID(或名称)Amazon AppConfig应用程序、环境和配置配置文件。API 返回InitialConfigurationToken用于获取配置数据。

aws appconfigdata start-configuration-session \ --application-identifier application_name_or_ID \ --environment-identifier environment_name_or_ID \ --configuration-profile-identifier configuration_profile_name_or_ID

系统使用以下格式的信息进行响应。

{ "InitialConfigurationToken": initial configuration token }

开始会话后,使用InitialConfigurationToken调用GetLatest配置来获取配置数据。配置数据将保存到mydata.json文件。

aws appconfigdata get-latest-configuration \ --configuration-token initial configuration token mydata.json

第一次打电话GetLatestConfiguration使用ConfigurationToken从中获取StartConfigurationSession. 返回以下信息。

{ "NextPollConfigurationToken" : next configuration token, "ContentType" : content type of configuration, "NextPollIntervalInSeconds" : 60 }

后续调用GetLatestConfiguration 必须提供NextPollConfigurationToken来自上一次响应。

aws appconfigdata get-latest-configuration \ --configuration-token next configuration token mydata.json
重要

请注意有关的以下重要详细信息GetLatestConfigurationAPI 操作:

  • 这些区域有:GetLatestConfiguration响应包括Configuration显示配置数据的部分。这些区域有:Configuration仅当系统找到新的或更新的配置数据时才会显示部分。如果系统找不到新的或更新的配置数据,那么Configuration数据为空。

  • 你会收到一个新的ConfigurationToken在来自的每一个回复GetLatestConfiguration.

  • 我们建议您根据预算、配置部署的预期频率以及配置目标数以调整 GetLatestConfiguration API 调用的轮询频率。