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 données de configuration sans AWS AppConfig agent
La méthode recommandée pour récupérer les données de configuration AWS AppConfig consiste à utiliser l'agent développé et géré AWS AppConfig par Amazon. Avec l'agent, vous pouvez mettre en cache les données de configuration localement et interroger le service de plan de AWS AppConfig données de manière asynchrone pour obtenir des mises à jour. Ce caching/polling processus garantit que vos données de configuration sont toujours disponibles pour votre application tout en minimisant la latence et les coûts. Si vous préférez ne pas utiliser l'agent, vous pouvez appeler le public APIs directement depuis le service de plan de AWS AppConfig données.
Le service de plan de données utilise deux actions d'API, [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)et [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html). Le service de plan de données utilise également des [points de terminaison distincts](https://docs.aws.amazon.com/general/latest/gr/appconfig.html#appconfigdata_data_plane) du plan de AWS AppConfig contrôle.
**Note**
Le service de plan de données remplace le processus précédent de récupération des données de configuration à l'aide de l'action `GetConfiguration` API. L'`GetConfiguration`API est obsolète.
**Comment ça marche**
Voici comment fonctionne le processus d'appel direct à AWS AppConfig APIs l'aide du service de plan de données.
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](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API. Le client de votre session passe ensuite des appels périodiques [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html)pour vérifier et récupérer les dernières données disponibles.
Lorsque vous appelez`StartConfigurationSession`, 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 revient`BadRequestException`.
Lorsque vous appelez`GetLatestConfiguration`, 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 appel`GetLatestConfiguration`.
+ 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.
L'[StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API 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'un`KmsKeyIdentifier`, votre demande de réception de la configuration doit inclure l'autorisation d'appel`kms:Decrypt`. Pour plus d'informations, voir [Déchiffrer](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) dans la *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.
## (Exemple) Récupération d'une configuration en appelant AWS AppConfig APIs
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 le IDs (ou les 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](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html#API_appconfigdata_StartConfigurationSession_ResponseSyntax)to call [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html)pour 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 de`StartConfigurationSession`. 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 de`GetLatestConfiguration`.
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.