第 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，以建立与服务的会话。这通常是在应用程序启动时或在首次检索配置之前完成的。

  • 这些区域有：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
}

开始会话后，使用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 调用的轮询频率。