Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Recuperación de datos de configuración sin el agente AWS AppConfig
La forma recomendada de recuperar los datos de configuración AWS AppConfig es mediante el Amazon-developed AWS AppConfig agente gestionado. Con el agente, puede almacenar en caché los datos de configuración de forma local y sondear de forma asíncrona el servicio del plano de AWS AppConfig datos en busca de actualizaciones. Este caching/polling proceso garantiza que los datos de configuración estén siempre disponibles para su aplicación y, al mismo tiempo, minimiza la latencia y los costes. Si prefiere no utilizar el agente, puede llamar a las API públicas directamente desde el servicio de plano de AWS AppConfig datos.
El servicio de plano de datos utiliza dos acciones de API: [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)y [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html). El servicio de plano de datos también utiliza [puntos finales independientes](https://docs.aws.amazon.com/general/latest/gr/appconfig.html#appconfigdata_data_plane) del plano de AWS AppConfig control.
**nota**
El servicio de plano de datos reemplaza el proceso anterior de recuperación de datos de configuración mediante la acción de API `GetConfiguration`. La API `GetConfiguration` ha quedado obsoleta.
**Funcionamiento**
Así es como funciona el proceso de llamar directamente a AWS AppConfig las API mediante el servicio de plano de datos.
La aplicación recupera los datos de configuración estableciendo primero una sesión de configuración mediante la operación de la [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API. A continuación, el cliente de la sesión realiza llamadas periódicas a [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html) para comprobar y recuperar los datos más recientes disponibles.
Al llamar a `StartConfigurationSession`, el código envía la siguiente información:
+ Identificadores (ID o nombre) de una AWS AppConfig aplicación, un entorno y un perfil de configuración que la sesión rastrea.
+ (Opcional) Tiempo mínimo que el cliente de la sesión debe esperar entre llamadas a `GetLatestConfiguration`.
Como respuesta, AWS AppConfig proporciona un valor `InitialConfigurationToken` que se proporciona al cliente de la sesión y se utiliza la primera vez que llama a `GetLatestConfiguration` esa sesión.
**importante**
Este token solo debe usarse una vez en la primera llamada a `GetLatestConfiguration`. *Debe* usar el nuevo token en la respuesta de `GetLatestConfiguration` (`NextPollConfigurationToken`) en cada llamada posterior a `GetLatestConfiguration`. Para admitir los casos de uso de sondeos prolongados, los tokens son válidos durante un máximo de 24 horas. Si en una llamada a `GetLatestConfiguration` se utiliza un token caducado, el sistema devuelve `BadRequestException`.
Al llamar a `GetLatestConfiguration`, su código de cliente envía el valor más reciente de `ConfigurationToken` del que dispone y recibe como respuesta:
+ `NextPollConfigurationToken`: el valor de `ConfigurationToken` que se utilizará en la siguiente llamada a `GetLatestConfiguration`.
+ `NextPollIntervalInSeconds`: Tiempo que el cliente debe esperar antes de realizar su próxima llamada a `GetLatestConfiguration`.
+ Configuración: los datos más recientes destinados a la sesión. Puede estar vacía si el cliente ya tiene la versión más reciente de la configuración.
**importante**
Tenga en cuenta la siguiente información importante.
Solo se debe llamar a la [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API una vez por aplicación, entorno, perfil de configuración y cliente para establecer una sesión con el servicio. Por lo general, se hace al iniciar la aplicación o inmediatamente antes de recuperar una configuración por primera vez.
Si la configuración se implementa mediante un `KmsKeyIdentifier`, la solicitud para recibir la configuración debe incluir el permiso para llamar a `kms:Decrypt`. Para obtener más información, consulte [Descifrar](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) en la *Guía de referencia de la API de AWS Key Management Service *.
La operación de API que se utilizaba anteriormente para recuperar los datos de configuración, `GetConfiguration`, ha quedado obsoleta. La operación de API `GetConfiguration` no admite configuraciones cifradas.
## (Ejemplo) Recuperar una configuración mediante una llamada a las API AWS AppConfig
En el siguiente AWS CLI ejemplo, se muestra cómo recuperar los datos de configuración mediante las operaciones AWS AppConfig de datos `StartConfigurationSession` y `GetLatestConfiguration` API. El primer comando inicia una sesión de configuración. Esta llamada incluye los ID (o nombres) de la AWS AppConfig aplicación, el entorno y el perfil de configuración. La API devuelve un `InitialConfigurationToken` que se utiliza para recuperar los datos de configuración.
```
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}}
```
El sistema devuelve información similar al siguiente formato.
```
{
"InitialConfigurationToken": {{initial configuration token}}
}
```
Tras iniciar una sesión, utilice esta función [InitialConfigurationToken[GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html)](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html#API_appconfigdata_StartConfigurationSession_ResponseSyntax)para llamar y obtener los datos de configuración. Los datos de configuración se guardan en el archivo `mydata.json`.
```
aws appconfigdata get-latest-configuration \
--configuration-token {{initial configuration token}} mydata.json
```
La primera llamada a `GetLatestConfiguration` utiliza el `ConfigurationToken` obtenido de `StartConfigurationSession`. Se devuelve la siguiente información.
```
{
"NextPollConfigurationToken" : {{next configuration token}},
"ContentType" : {{content type of configuration}},
"NextPollIntervalInSeconds" : {{60}}
}
```
Las llamadas posteriores a `GetLatestConfiguration` *deben* proporcionar el `NextPollConfigurationToken` de la respuesta anterior.
```
aws appconfigdata get-latest-configuration \
--configuration-token {{next configuration token}} mydata.json
```
**importante**
Tenga en cuenta los siguientes detalles importantes acerca de la operación de API `GetLatestConfiguration`:
La respuesta de `GetLatestConfiguration` incluye una sección `Configuration` que muestra los datos de configuración. La sección `Configuration` solo aparece si el sistema encuentra datos de configuración nuevos o actualizados. Si el sistema no encuentra datos de configuración nuevos o actualizados, los datos de `Configuration` están vacíos.
Recibirá un nuevo `ConfigurationToken` en cada respuesta de `GetLatestConfiguration`.
Recomendamos ajustar la frecuencia de sondeo de las llamadas a la API `GetLatestConfiguration` en función del presupuesto, la frecuencia esperada de las implementaciones de configuración y el número de destinos para una configuración.