Recuperando configurações chamando diretamente APIs - AWS AppConfig

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Recuperando configurações chamando diretamente APIs

Seu aplicativo recupera os dados de configuração estabelecendo primeiro uma sessão de configuração usando a StartConfigurationSessionAPIoperação. Em seguida, o cliente da sua sessão faz chamadas periódicas GetLatestConfigurationpara verificar e recuperar os dados mais recentes disponíveis.

Ao chamar StartConfigurationSession, seu código envia as seguintes informações:

  • Identificadores (ID ou nome) de um AWS AppConfig aplicativo, ambiente e perfil de configuração que a sessão rastreia.

  • (Opcional) O tempo mínimo que o cliente da sessão deve esperar entre chamadas para GetLatestConfiguration.

Em resposta, AWS AppConfig fornece um InitialConfigurationToken a ser entregue ao cliente da sessão e usado na primeira vez em que ele liga GetLatestConfiguration para essa sessão.

Importante

Esse token só deve ser usado uma vez em sua primeira chamada para GetLatestConfiguration. Você deve usar o novo token na resposta GetLatestConfiguration (NextPollConfigurationToken) em cada chamada subseqüente para GetLatestConfiguration. Para oferecer suporte a casos de uso de pesquisas longas, os tokens são válidos por até 24 horas. Se uma chamada GetLatestConfiguration usar um token expirado, o sistema retornará BadRequestException.

Ao chamar GetLatestConfiguration, seu código de cliente envia o valor ConfigurationToken mais recente que ele tem e recebe em resposta:

  • NextPollConfigurationToken: o valor ConfigurationToken a ser usado na próxima chamada para GetLatestConfiguration.

  • NextPollIntervalInSeconds: o tempo que o cliente deve esperar até fazer sua próxima chamada para GetLatestConfiguration.

  • A configuração: os dados mais recentes destinados à sessão. Este pode estar vazio se o cliente já tiver a versão mais recente da configuração.

Importante

Observe as seguintes informações importantes:

  • O só StartConfigurationSessionAPIdeve ser chamado uma vez por aplicativo, ambiente, perfil de configuração e cliente para estabelecer uma sessão com o serviço. Isso geralmente é feito no startup do aplicativo ou imediatamente antes da primeira recuperação de uma configuração.

  • Se sua configuração for implantada usando um KmsKeyIdentifier, sua solicitação para receber a configuração deverá incluir permissão para chamar kms:Decrypt. Para obter mais informações, consulte Decrypt na Referência.AWS Key Management Service API

  • A API operação usada anteriormente para recuperar dados de configuração,GetConfiguration, está obsoleta. A GetConfiguration API operação não oferece suporte a configurações criptografadas.