Recupero delle configurazioni chiamando direttamente le API

L'applicazione recupera i dati di configurazione stabilendo prima una sessione di configurazione utilizzando l'operazione Session API. StartConfiguration Il client della sessione effettua quindi chiamate periodiche a GetLatestConfiguration per verificare e recuperare i dati più recenti disponibili.

Durante la chiamataStartConfigurationSession, 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 aGetLatestConfiguration. È necessario utilizzare il nuovo token nella GetLatestConfiguration risposta (NextPollConfigurationToken) in ogni chiamata successiva aGetLatestConfiguration. 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 chiamataGetLatestConfiguration, 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 aGetLatestConfiguration.

• NextPollIntervalInSeconds: la durata che il client deve attendere prima di effettuare la chiamata successivaGetLatestConfiguration.

• 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'API di StartConfigurationsessione 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 aKmsKeyIdentifier, la richiesta di ricezione della configurazione deve includere l'autorizzazione alla chiamata. kms:Decrypt Per ulteriori informazioni, consulta Decrypt nel riferimento API.AWS Key Management Service

• L'operazione API precedentemente utilizzata per recuperare i dati di configurazioneGetConfiguration, è obsoleta. L'operazione GetConfiguration API non supporta configurazioni crittografate.

Recupero di un esempio di configurazione

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 gli ID (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 per chiamare GetLatestConfiguration 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 daStartConfigurationSession. 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'GetLatestConfigurationAPI:

• 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 daGetLatestConfiguration.

• 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.