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

# Come utilizzare AWS AppConfig Agent per recuperare i dati di configurazione
<a name="appconfig-agent-how-to-use"></a>

L' AWS AppConfig Agent è il metodo consigliato per recuperare i flag di AWS AppConfig funzionalità o i dati di configurazione in formato libero. L'agente è supportato su tutte le forme di AWS elaborazione, tra cui Amazon EC2, Amazon ECS, Amazon EKS e Lambda. Dopo aver completato la configurazione iniziale dell'agente, utilizzare l'agente per recuperare i dati di configurazione è più semplice che chiamare direttamente le API. AWS AppConfig L'agente implementa automaticamente le migliori pratiche e può ridurre i costi di utilizzo grazie AWS AppConfig al minor numero di chiamate API per il recupero delle configurazioni.

**Nota**  
Il recupero dei dati di configurazione da un dispositivo separato non è supportato. Account AWS 

## Utilizzo di AWS AppConfig Agent per distribuzioni graduali basate su utenti o entità
<a name="appconfig-entity-based-gradual-deployments"></a>

AWS AppConfig L'agente supporta la distribuzione di feature flag o dati di configurazione in formato libero a segmenti specifici o singoli utenti durante un'implementazione graduale. Entity-based le distribuzioni graduali assicurano che, una volta che un utente o un segmento riceve una versione di configurazione, continui a ricevere la stessa versione per tutto il periodo di implementazione, indipendentemente dalla risorsa di elaborazione che soddisfa le sue richieste.

Con le distribuzioni graduali basate su entità, AWS AppConfig Agent valuta un identificatore univoco () fornito con ogni richiesta HTTP. `Entity-Id` Sulla base di questo identificatore, l'agente fornisce costantemente la versione di configurazione nuova o precedente per tutto il periodo di distribuzione. Questo processo garantisce che, una volta ricevuta la configurazione aggiornata, l'utente continui a riceverla. Garantisce inoltre che gli allarmi di rollback dispongano di tempo e dati sufficienti per rilevare i problemi.

Prendi in considerazione le implementazioni graduali basate su entità se una configurazione modifica direttamente il comportamento rivolto agli utenti e se la modifica del raggio di esplosione (che ha un impatto completo su utenti specifici anziché su tutti gli utenti in parte) è accettabile per la tua applicazione.

**Importante**  
Nota le seguenti informazioni importanti sulle distribuzioni graduali basate su entità:  
Entity-based le distribuzioni graduali richiedono la versione dell'agente 2.0.136060 o successiva. AWS AppConfig 
`Entity-Id`accetta una dimensione massima della stringa di 2 KB.
Gli identificatori univoci non devono essere codificati o avere una cardinalità bassa.
Gli identificatori non vengono inviati al servizio. AWS AppConfig AWS AppConfig L'agente valuta gli identificatori univoci sul lato client.
Durante una distribuzione, l' AWS AppConfig agente tiene traccia delle entità e delle configurazioni distribuite. Questo tracciamento viene mantenuto solo durante un periodo di distribuzione. Il tracciamento termina al termine della distribuzione.
Ogni istanza di AWS AppConfig sondaggio per la distribuzione è indipendente, quindi gli agenti possono fornire brevemente versioni diverse della stessa entità in base alla variazione della percentuale di distribuzione. Questa finestra è determinata dall'intervallo di sondaggio e da un breve periodo di sincronizzazione. Puoi ridurlo impostando l'azione `RequiredMinimumPollIntervalInSeconds` API. [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html) Tuttavia, intervalli più brevi aumentano la frequenza delle chiamate API, il che può far aumentare i costi e rischiare di limitare il traffico. Scegliete un intervallo di sondaggio che soddisfi le vostre esigenze. Per ulteriori informazioni, consulta la sezione [StartConfigurationSession](https://docs.aws.amazon.com/cli/latest/reference/appconfigdata/start-configuration-session.html)Reference. AWS CLI 

### Abilitazione di distribuzioni graduali basate sull'entità
<a name="appconfig-entity-based-gradual-deployments-enabling"></a>

Per abilitare implementazioni graduali basate sull'entità:

1. Aggiornamento alla versione dell' AWS AppConfig agente 2.0.136060 o successiva.

1. Fornisci un identificatore univoco nell'intestazione `Entity-Id` HTTP durante il recupero dei dati di configurazione.

La seguente richiesta di esempio utilizza un indirizzo e-mail per `Entity-Id`

```
GET /applications/myapp/environments/prod/configurations/featureflags HTTP/1.1
Host: localhost:2772
Entity-Id: example@AWS-example-email.com
```

Puoi includere l'`Entity-Id`intestazione nelle richieste per:

/applications/ {Applicazione} /environments/ {Ambiente} /configurations/ {Configurazione}

Per visualizzare esempi di codice `Entity-Id` [Utilizzo di AWS AppConfig Agent per leggere un profilo di configurazione in formato libero](appconfig-code-samples-agent-read-configuration.md) con, vedi.

Il `Entity-Id` valore può essere qualsiasi stringa che identifica in modo univoco un'entità nel sistema, ad esempio:
+ ID cliente
+ Indirizzo e-mail
+ ID account
+ ID del lavoro di backend
+ Session-scoped identificatore (se appropriato)