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á.
# Como usar o AWS AppConfig Agent para recuperar dados de configuração
O AWS AppConfig Agente é o método recomendado para recuperar sinalizadores de AWS AppConfig recursos ou dados de configuração de formato livre. O agente é compatível com todas as formas de AWS computação, incluindo Amazon EC2, Amazon ECS, Amazon EKS e Lambda. Depois de concluir a configuração inicial do agente, usar o agente para recuperar dados de configuração é mais simples do que chamar AWS AppConfig diretamente as APIs. O agente implementa automaticamente as melhores práticas e pode reduzir seu custo de uso AWS AppConfig como resultado de menos chamadas de API para recuperar as configurações.
**nota**
A recuperação de dados de configuração de um arquivo separado Conta da AWS não é suportada.
## Usando o AWS AppConfig Agent para implantações graduais baseadas em usuários ou entidades
AWS AppConfig O agente suporta a implantação de sinalizadores de recursos ou dados de configuração de formato livre para segmentos específicos ou usuários individuais durante uma implantação gradual. Entity-based implantações graduais garantem que, quando um usuário ou segmento recebe uma versão de configuração, ele continue recebendo essa mesma versão durante todo o período de implantação, independentemente de qual recurso computacional atenda às suas solicitações.
Com implantações graduais baseadas em entidades, o AWS AppConfig Agente avalia um identificador exclusivo (`Entity-Id`) fornecido com cada solicitação HTTP. Com base nesse identificador, o agente fornece consistentemente a versão de configuração nova ou anterior durante todo o período de implantação. Esse processo garante que, uma vez que o usuário receba a configuração atualizada, ele continue a recebê-la. Também garante que os alarmes de reversão tenham tempo e dados suficientes para detectar problemas.
Considere implantações graduais baseadas em entidades se uma configuração alterar diretamente o comportamento voltado para o usuário e se a mudança no raio de explosão (afetando totalmente usuários específicos, em vez de afetar parcialmente todos os usuários) for aceitável para seu aplicativo.
**Importante**
Observe as seguintes informações importantes sobre implantações graduais baseadas em entidades:
Entity-based implantações graduais exigem a versão 2.0.136060 ou posterior do AWS AppConfig Agent.
`Entity-Id`aceita um tamanho máximo de string de 2 KB.
Os identificadores exclusivos não devem ser codificados ou ter baixa cardinalidade.
Os identificadores não são enviados para o AWS AppConfig serviço. AWS AppConfig O agente avalia identificadores exclusivos do lado do cliente.
Durante uma implantação, o AWS AppConfig Agente acompanha as entidades e as configurações implantadas. Esse rastreamento é mantido somente durante um período de implantação. O rastreamento termina quando a implantação é concluída.
Cada instância das AWS AppConfig pesquisas para implantação é independente, portanto, os agentes podem fornecer brevemente versões diferentes da mesma entidade à medida que a porcentagem de implantação muda. Essa janela é determinada pelo intervalo da pesquisa e por um curto período de sincronização. Você pode reduzi-lo configurando `RequiredMinimumPollIntervalInSeconds` a ação [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)da API. No entanto, intervalos mais curtos aumentam as taxas de chamadas da API, o que pode aumentar os custos e aumentar o risco de limitação. Escolha um intervalo de votação que atenda às suas necessidades. Para obter mais informações, consulte [StartConfigurationSession](https://docs.aws.amazon.com/cli/latest/reference/appconfigdata/start-configuration-session.html)na AWS CLI Referência.
### Possibilitando implantações graduais baseadas em entidades
Para permitir implantações graduais baseadas em entidades:
1. Atualize para a versão 2.0.136060 ou posterior do AWS AppConfig Agent.
1. Forneça um identificador exclusivo no cabeçalho `Entity-Id` HTTP ao recuperar dados de configuração.
O exemplo de solicitação a seguir usa um endereço de e-mail para `Entity-Id`
```
GET /applications/myapp/environments/prod/configurations/featureflags HTTP/1.1
Host: localhost:2772
Entity-Id: example@AWS-example-email.com
```
Você pode incluir o `Entity-Id` cabeçalho nas solicitações para:
/applications/ {Aplicativo} /ambientes/ {Ambiente} /configurações/ {Configuração}
Para ver exemplos de código com`Entity-Id`, consulte[Usando o AWS AppConfig Agente para ler um perfil de configuração de formato livre](appconfig-code-samples-agent-read-configuration.md).
O `Entity-Id` valor pode ser qualquer string que identifique de forma exclusiva uma entidade em seu sistema, como:
+ ID da do cliente
+ Endereço de e-mail
+ ID da conta
+ ID do trabalho de back-end
+ Session-scoped identificador (se apropriado)