本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
第 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
和NextPollConfigurationToken
24 小时后过期。如果GetLatestConfiguration
调用使用过期的令牌,系统返回BadRequestException
.
检索配置示例
以下Amazon CLI示例演示了如何使用Amazon AppConfig 数据StartConfigurationSession
和GetLatestConfiguration
API 操作。第一个命令启动配置会话。此调用包括的 ID(或名称)Amazon AppConfig应用程序、环境和配置配置文件。API 返回InitialConfigurationToken
用于获取配置数据。
aws appconfigdata start-configuration-session \ --application-identifier
application_name_or_ID
\ --environment-identifierenvironment_name_or_ID
\ --configuration-profile-identifierconfiguration_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
请注意有关的以下重要详细信息GetLatestConfiguration
API 操作:
-
这些区域有:
GetLatestConfiguration
响应包括Configuration
显示配置数据的部分。这些区域有:Configuration
仅当系统找到新的或更新的配置数据时才会显示部分。如果系统找不到新的或更新的配置数据,那么Configuration
数据为空。 -
你会收到一个新的
ConfigurationToken
在来自的每一个回复GetLatestConfiguration
. -
我们建议您根据预算、配置部署的预期频率以及配置目标数以调整
GetLatestConfiguration
API 调用的轮询频率。