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

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

第 6 步：检索配置

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

打电话时StartConfigurationSession，代码发送以下信息：

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

  • （可选）会话客户端在调用之间必须等待的最短时间。GetLatestConfiguration.

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

重要

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

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

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

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

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

重要

请注意以下重要信息。

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

  • 这些区域有：InitialConfigurationToken和NextPollConfigurationToken24 小时后过期。如果GetLatestConfiguration调用使用过期的令牌，系统返回BadRequestException.

检索配置示例

以下Amazon CLI示例演示了如何使用Amazon AppConfig 数据StartConfigurationSession和GetLatestConfigurationAPI 操作。第一个命令启动配置会话。此调用包括的 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
}

开始会话后，使用初始配置令牌调用此项获取最新配置来获取配置数据。配置数据将保存到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 调用的轮询频率。