Récupération de configurations en appelant directement des API

Votre application récupère les données de configuration en établissant d'abord une session de configuration à l'aide de l'opération StartConfigurationSession API. Le client de votre session appelle ensuite périodiquement GetLatestConfiguration pour 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 possède déjà la dernière version de la configuration.

Important

Notez les informations importantes suivantes.

• L'API de StartConfigurationsession ne doit être appelée 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, consultez Déchiffrer dans le guide de référence de l'AWS Key Management Service API.

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

Récupération d'un exemple de configuration

L' AWS CLI exemple suivant montre comment récupérer des données de configuration à l'aide des opérations AWS AppConfig Data StartConfigurationSession et GetLatestConfiguration API. La première commande lance une session de configuration. Cet appel inclut les identifiants (ou noms) de l' AWS AppConfig application, de l'environnement et du profil de configuration. L'API renvoie un fichier InitialConfigurationToken utilisé pour récupérer vos données de configuration.

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 

Le système répond avec les informations au format suivant.

{
   "InitialConfigurationToken": initial configuration token
}

Après avoir démarré une session, utilisez InitialConfigurationToken pour appeler GetLatestConfiguration afin de récupérer vos données de configuration. Les données de configuration sont enregistrées dans le mydata.json fichier.

aws appconfigdata get-latest-configuration \
    --configuration-token initial configuration token mydata.json

Le premier GetLatestConfiguration appel à utiliser le format ConfigurationToken obtenu à partir deStartConfigurationSession. Les informations suivantes sont renvoyées.

{
    "NextPollConfigurationToken" : next configuration token,
    "ContentType" : content type of configuration,
    "NextPollIntervalInSeconds" : 60
}  

Les appels suivants GetLatestConfiguration doivent fournir des informations NextPollConfigurationToken issues de la réponse précédente.

aws appconfigdata get-latest-configuration \
    --configuration-token next configuration token mydata.json

Important

Notez les informations importantes suivantes concernant le fonctionnement de GetLatestConfiguration l'API :

• La GetLatestConfiguration réponse inclut une Configuration section qui présente les données de configuration. La Configuration section apparaît uniquement si le système trouve des données de configuration nouvelles ou mises à jour. Si le système ne trouve pas de données de configuration nouvelles ou mises à jour, les Configuration données sont vides.

• Vous recevez un nouveau message ConfigurationToken à chaque réponse deGetLatestConfiguration.

• Nous vous recommandons de régler la fréquence d'interrogation de vos appels d'API GetLatestConfiguration en fonction de votre budget, de la fréquence prévue de vos déploiements de configuration et du nombre de cibles pour une configuration.