Récupération des configurations en appelant directement APIs - AWS AppConfig

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Récupération des configurations en appelant directement APIs

Votre application récupère les données de configuration en établissant d'abord une session de configuration à l'aide de l'StartConfigurationSessionAPIopération. Le client de votre session passe ensuite des appels périodiques GetLatestConfigurationpour vérifier et récupérer les dernières données disponibles.

Lorsque vous appelezStartConfigurationSession, votre code envoie les informations suivantes :

  • Identifiants (ID ou nom) d'une AWS AppConfig application, d'un environnement et d'un profil de configuration suivis par la session.

  • (Facultatif) Durée minimale pendant laquelle le client de la session doit attendre entre les appels àGetLatestConfiguration.

En réponse, AWS AppConfig fournit un InitialConfigurationToken à donner au client de la session et à utiliser la première fois qu'il appelle GetLatestConfiguration cette session.

Important

Ce jeton ne doit être utilisé qu'une seule fois lors de votre premier appel àGetLatestConfiguration. Vous devez utiliser le nouveau jeton dans la GetLatestConfiguration réponse (NextPollConfigurationToken) lors de chaque appel suivant àGetLatestConfiguration. Pour prendre en charge les longs cas d'utilisation des sondages, les jetons sont valables jusqu'à 24 heures. Si un GetLatestConfiguration appel utilise un jeton expiré, le système revientBadRequestException.

Lorsque vous appelezGetLatestConfiguration, votre code client envoie la ConfigurationToken valeur la plus récente qu'il possède et reçoit en réponse :

  • NextPollConfigurationToken: ConfigurationToken valeur à utiliser lors du prochain appel àGetLatestConfiguration.

  • NextPollIntervalInSeconds: la durée pendant laquelle le client doit attendre avant de passer son prochain appelGetLatestConfiguration.

  • La configuration : les dernières données destinées à la session. Ce champ peut être vide si le client dispose déjà de la dernière version de la configuration.

Important

Notez les informations importantes suivantes.

  • Le ne StartConfigurationSessionAPIdoit être appelé qu'une seule fois par application, environnement, profil de configuration et client pour établir une session avec le service. Cela se fait généralement au démarrage de votre application ou juste avant la première récupération d'une configuration.

  • Si votre configuration est déployée à l'aide d'unKmsKeyIdentifier, votre demande de réception de la configuration doit inclure l'autorisation d'appelkms:Decrypt. Pour plus d'informations, voir Déchiffrer dans la AWS Key Management Service APIréférence.

  • L'APIopération précédemment utilisée pour récupérer les données de GetConfiguration configuration est obsolète. L'GetConfigurationAPIopération ne prend pas en charge les configurations chiffrées.