View a markdown version of this page

Recupero dei dati di configurazione senza AWS AppConfig Agente - AWS AppConfig
(Esempio) Recupero di una configurazione chiamando AWS AppConfig API

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 AWS AppConfig Agente

Il modo consigliato per recuperare i dati di configurazione AWS AppConfig è utilizzare l' AWS AppConfig agente gestito Amazon-developed e gestito. Con l'agente, è possibile memorizzare nella cache i dati di configurazione localmente e interrogare in modo asincrono il servizio AWS AppConfig Data Plane per gli aggiornamenti. Questo caching/polling processo garantisce che i dati di configurazione siano sempre disponibili per l'applicazione, riducendo al minimo latenza e costi. Se preferisci non utilizzare l'agente, puoi chiamare le API pubbliche direttamente dal servizio AWS AppConfig data plane.

Il servizio data plane utilizza due azioni API StartConfigurationSession e GetLatestConfiguration. Il servizio data plane utilizza anche endpoint separati dal piano di AWS AppConfig controllo.

Nota

Il servizio data plane sostituisce il precedente processo di recupero dei dati di configurazione utilizzando l'azione API. GetConfiguration L'GetConfigurationAPI è obsoleta.

Come funziona

Ecco come funziona il processo di chiamata diretta alle AWS AppConfig API utilizzando il servizio data plane.

L'applicazione recupera i dati di configurazione stabilendo innanzitutto una sessione di configurazione utilizzando l'operazione StartConfigurationSession API. Il client della sessione effettua quindi chiamate periodiche per GetLatestConfiguration verificare e recuperare gli ultimi dati disponibili.

Quando si chiamaStartConfigurationSession, il codice invia le seguenti informazioni:

  • Identificatori (ID o nome) di un' AWS AppConfig applicazione, di un ambiente e di un profilo di configurazione tracciati dalla sessione.

  • (Facoltativo) Il tempo minimo 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 utilizzato solo una volta nella prima chiamata aGetLatestConfiguration. È necessario utilizzare il nuovo token nella GetLatestConfiguration risposta (NextPollConfigurationToken) in ogni chiamata successiva aGetLatestConfiguration. Per supportare i casi d'uso prolungati dei sondaggi, i token sono validi fino a 24 ore. Se una GetLatestConfiguration chiamata utilizza un token scaduto, il sistema ritorna. BadRequestException

Quando si chiamaGetLatestConfiguration, il codice cliente invia il ConfigurationToken valore più recente e riceve in risposta:

  • NextPollConfigurationToken: il ConfigurationToken valore da utilizzare nella prossima chiamata aGetLatestConfiguration.

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

  • La configurazione: i dati più recenti destinati alla sessione. Può essere vuoto se il client dispone già dell'ultima versione della configurazione.

Importante

Prendi nota delle seguenti informazioni importanti.

  • L'StartConfigurationSessionAPI deve essere chiamata una sola 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 implementata utilizzando unKmsKeyIdentifier, la richiesta di ricezione della configurazione deve includere l'autorizzazione alla chiamata. kms:Decrypt Per ulteriori informazioni, consulta Decrypt nell'API Reference. AWS Key Management Service

  • L'operazione API utilizzata in precedenza per recuperare i dati di configurazione è obsoletaGetConfiguration. L'operazione GetConfiguration API non supporta configurazioni crittografate.

(Esempio) Recupero di una configurazione chiamando AWS AppConfig API

L' AWS CLI esempio seguente dimostra 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 utente InitialConfigurationToken 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 to call 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 a GetLatestConfiguration utilizza il risultato ConfigurationToken ottenuto daStartConfigurationSession. Vengono restituite le seguenti informazioni.

{
    "NextPollConfigurationToken" : next configuration token,
    "ContentType" : content type of configuration,
    "NextPollIntervalInSeconds" : 60
}

Le successive chiamate a GetLatestConfiguration devono NextPollConfigurationToken provenire dalla risposta precedente.

aws appconfigdata get-latest-configuration \
    --configuration-token next configuration token mydata.json
Importante

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

  • Riceverai una nuova risposta 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.