本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
通过直接调用来检索配置 APIs
您的应用程序通过首先使用StartConfigurationSessionAPI操作建立配置会话来检索配置数据。然后,您的会话客户端会定期致电GetLatestConfiguration以检查和检索最新的可用数据。
在调用 StartConfigurationSession
时,代码发送以下信息:
-
会话跟踪的 AWS AppConfig 应用程序、环境和配置文件的标识符(ID 或名称)。
-
(可选)会话的客户端在调用至
GetLatestConfiguration
之间必须等待的最短时间。
作为响应, AWS AppConfig 提供InitialConfigurationToken
给会话的客户端,并在它第一次调GetLatestConfiguration
用该会话时使用。
重要
此令牌在第一次调用 GetLatestConfiguration
时只能使用一次。您必须在对 GetLatestConfiguration
的每次后续调用中在 GetLatestConfiguration
响应 (NextPollConfigurationToken
) 中使用新令牌。为了支持长时间轮询用例,令牌的有效期最长为 24 小时。如果 GetLatestConfiguration
调用使用过期的令牌,系统将返回 BadRequestException
。
调用 GetLatestConfiguration
时,您的客户端代码会发送它所拥有的最新 ConfigurationToken
值,并接收响应:
-
NextPollConfigurationToken
:下次调用GetLatestConfiguration
时要使用的ConfigurationToken
值。 -
NextPollIntervalInSeconds
:客户端在下次调用GetLatestConfiguration
之前应等待的持续时间。 -
配置:用于会话的最新数据。如果客户端已有最新版本的配置,则此字段可能为空。
重要
请注意以下重要信息。
-
每个应用程序、环境、配置文件和客户端StartConfigurationSessionAPI只能调用一次,才能与服务建立会话。这通常在应用程序启动时或首次检索配置之前完成。
-
如果您的配置是使用
KmsKeyIdentifier
部署的,则接收配置的请求必须包含调用kms:Decrypt
的权限。有关更多信息,请参阅参考资料中的解密。AWS Key Management Service API -
不建议使用以前用于检索配置数据的API操作。
GetConfiguration
该GetConfiguration
API操作不支持加密配置。