通过直接调用来检索配置 APIs - AWS AppConfig

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

通过直接调用来检索配置 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操作。GetConfigurationGetConfigurationAPI操作不支持加密配置。