Recupero delle configurazioni chiamando direttamente APIs - AWS AppConfig

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 delle configurazioni chiamando direttamente APIs

L'applicazione recupera i dati di configurazione stabilendo prima una sessione di configurazione utilizzando l'operazione. StartConfigurationSessionAPI Il client della sessione effettua quindi chiamate periodiche per GetLatestConfigurationverificare 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 fornire 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.

  • StartConfigurationSessionAPIDeve essere chiamato 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.AWS Key Management Service API

  • L'APIoperazione utilizzata in precedenza per recuperare i dati di configurazioneGetConfiguration, è obsoleta. L'GetConfigurationAPIoperazione non supporta configurazioni crittografate.