Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Recupero dei dati di configurazione senza Agent AWS AppConfig
Il modo consigliato per recuperare i dati di configurazione AWS AppConfig è utilizzare l'agente sviluppato e gestito da Amazon. AWS AppConfig Con l'agente, puoi memorizzare nella cache i dati di configurazione localmente e interrogare in modo asincrono il servizio Data Plane per verificare la presenza di aggiornamenti. AWS AppConfig Questo caching/polling processo garantisce che i dati di configurazione siano sempre disponibili per l'applicazione, riducendo al minimo la latenza e i costi. Se preferisci non utilizzare l'agente, puoi effettuare chiamate pubbliche APIs direttamente dal servizio AWS AppConfig Data Plane.
Il servizio data plane utilizza due azioni API [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)e [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html). Il servizio del piano dati utilizza anche [endpoint separati](https://docs.aws.amazon.com/general/latest/gr/appconfig.html#appconfigdata_data_plane) dal piano AWS AppConfig di controllo.
**Nota**
Il servizio del piano dati sostituisce il precedente processo di recupero dei dati di configurazione utilizzando l'azione API. `GetConfiguration` L'`GetConfiguration`API è obsoleta.
**Come funziona**
Ecco come funziona il processo di chiamata diretta AWS AppConfig APIs tramite il servizio data plane.
L'applicazione recupera i dati di configurazione stabilendo prima una sessione di configurazione utilizzando l'operazione [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API. Il client della sessione effettua quindi chiamate periodiche per [GetLatestConfiguration](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_GetLatestConfiguration.html)verificare e recuperare i dati più recenti disponibili.
Durante la chiamata`StartConfigurationSession`, il codice invia le seguenti informazioni:
+ Identificatori (ID o nome) di un' AWS AppConfig applicazione, di un ambiente e di un profilo di configurazione monitorati dalla sessione.
+ (Facoltativo) La quantità minima di tempo che il client della sessione deve attendere tra una chiamata e l'altra. `GetLatestConfiguration`
In risposta, AWS AppConfig fornisce un `InitialConfigurationToken` messaggio da dare al client della sessione e da utilizzare la prima volta che effettua una chiamata `GetLatestConfiguration` per quella sessione.
**Importante**
Questo token deve essere usato solo una volta nella prima chiamata a`GetLatestConfiguration`. È *necessario* utilizzare il nuovo token nella `GetLatestConfiguration` risposta (`NextPollConfigurationToken`) in ogni chiamata successiva a`GetLatestConfiguration`. Per supportare casi d'uso prolungati con sondaggi, i token sono validi per un massimo di 24 ore. Se una `GetLatestConfiguration` chiamata utilizza un token scaduto, il sistema ritorna. `BadRequestException`
Durante la chiamata`GetLatestConfiguration`, il codice cliente invia il `ConfigurationToken` valore più recente a sua disposizione e riceve in risposta:
+ `NextPollConfigurationToken`: il `ConfigurationToken` valore da utilizzare nella chiamata successiva a`GetLatestConfiguration`.
+ `NextPollIntervalInSeconds`: la durata che il client deve attendere prima di effettuare la chiamata successiva`GetLatestConfiguration`.
+ La configurazione: i dati più recenti destinati alla sessione. Questo campo può essere vuoto se il client dispone già dell'ultima versione della configurazione.
**Importante**
Prendi nota delle seguenti informazioni importanti.
L'[StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API deve essere chiamata solo una volta per applicazione, ambiente, profilo di configurazione e client per stabilire una sessione con il servizio. Questa operazione viene in genere eseguita all'avvio dell'applicazione o immediatamente prima del primo recupero di una configurazione.
Se la configurazione viene distribuita utilizzando a`KmsKeyIdentifier`, la richiesta di ricezione della configurazione deve includere l'autorizzazione alla chiamata. `kms:Decrypt` *Per ulteriori informazioni, [consulta Decrypt](https://docs.aws.amazon.com/kms/latest/APIReference/API_Decrypt.html) nel riferimento API.AWS Key Management Service *
L'operazione API precedentemente utilizzata per recuperare i dati di configurazione`GetConfiguration`, è obsoleta. L'operazione `GetConfiguration` API non supporta configurazioni crittografate.
## (Esempio) Recupero di una configurazione chiamando AWS AppConfig APIs
L' AWS CLI esempio seguente mostra come recuperare i dati di configurazione utilizzando le AWS AppConfig operazioni Data e API. `StartConfigurationSession` `GetLatestConfiguration` Il primo comando avvia una sessione di configurazione. Questa chiamata include IDs (o i nomi) dell' AWS AppConfig applicazione, dell'ambiente e del profilo di configurazione. L'API restituisce un file `InitialConfigurationToken` usato per recuperare i dati di configurazione.
```
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
```
Il sistema risponde con informazioni nel formato seguente.
```
{
"InitialConfigurationToken": initial configuration token
}
```
Dopo aver avviato una sessione, usa [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)per recuperare i dati di configurazione. I dati di configurazione vengono salvati nel `mydata.json` file.
```
aws appconfigdata get-latest-configuration \
--configuration-token initial configuration token mydata.json
```
La prima chiamata `GetLatestConfiguration` utilizza il codice `ConfigurationToken` ottenuto da`StartConfigurationSession`. Vengono restituite le seguenti informazioni.
```
{
"NextPollConfigurationToken" : next configuration token,
"ContentType" : content type of configuration,
"NextPollIntervalInSeconds" : 60
}
```
Le chiamate successive `GetLatestConfiguration` *devono* `NextPollConfigurationToken` provenire dalla risposta precedente.
```
aws appconfigdata get-latest-configuration \
--configuration-token next configuration token mydata.json
```
**Importante**
Tieni presente i seguenti dettagli importanti sul funzionamento dell'`GetLatestConfiguration`API:
La `GetLatestConfiguration` risposta include una `Configuration` sezione che mostra i dati di configurazione. La `Configuration` sezione viene visualizzata solo se il sistema trova dati di configurazione nuovi o aggiornati. Se il sistema non trova dati di configurazione nuovi o aggiornati, i `Configuration` dati sono vuoti.
Ne ricevi uno nuovo `ConfigurationToken` in ogni risposta da`GetLatestConfiguration`.
Si consiglia di ottimizzare la frequenza di polling delle chiamate API `GetLatestConfiguration` in base al budget, alla frequenza prevista delle distribuzioni di configurazione e al numero di destinazioni per una configurazione.