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

# Aggiungere tag alle risorse in Connect Customer
<a name="tagging"></a>

Un *tag* è un'etichetta di metadati personalizzata che puoi aggiungere a una risorsa per semplificarne l'identificazione, l'organizzazione e l'individuazione in una ricerca. I tag sono costituiti da due parti: una chiave di tag e un valore di tag, Queste compongono una coppia *chiave:valore*.

Una *chiave di tag* rappresenta in genere una categoria più ampia, mentre un valore di tag rappresenta un sottoinsieme di quella categoria. Ad esempio, *tag key=Color* e *tag value=Blue* produrrebbero la coppia chiave-valore `Color:Blue`. Tieni presente che è possibile impostare il valore di un tag su una stringa vuota, ma non su null. Non specificare il valore del tag equivale a utilizzare una stringa vuota.



Le chiavi di tag possono avere una lunghezza massima di 128 caratteri e i valori di tag di 256 caratteri; entrambi distinguono tra minuscole e maiuscole. Per ulteriori informazioni, consulta:
+  [Connect Customer TagResource](https://docs.aws.amazon.com/connect/latest/APIReference/API_TagResource.html)
+  [Connect Customer Customer Customer TagResource](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_TagResource.html) 
+  [Connect Customer Voice ID TagResource](https://docs.aws.amazon.com/voiceid/latest/APIReference/API_TagResource.html): puoi aggiungere tag al dominio Voice ID. 
+  [Amazon AppIntegrations TagResource](https://docs.aws.amazon.com/appintegrations/latest/APIReference/API_TagResource.html) 

Il servizio clienti Connect supporta fino a 50 tag per risorsa. Per una determinata risorsa, ciascuna chiave di tag deve essere univoca e avere un solo valore. 

**Nota**  
I tag non possono iniziare con `aws:` perché AWS riserva questo prefisso ai tag generati dal sistema. Non puoi aggiungere, modificare o eliminare i tag `aws:*`, che non vengono conteggiati per il limite del numero di tag per risorsa.

La tabella seguente descrive le risorse Connect Customer che possono essere etichettate utilizzando AWS CLI o un AWS SDK.


**Supporto per l'etichettatura delle risorse Connect Customer**  

| Risorsa | Supporta l'etichettatura tramite il sito Web di amministrazione Connect Customer  | Supporta l'etichettatura utilizzando il CLI/SDK | Supporta l'applicazione di tag in fase di creazione | 
| --- | --- | --- | --- | 
| Agente | Sì  | Sì | Sì | 
| Gruppo di agenti | No | Sì | Sì | 
| Livello del gruppo di agenti | No | No | Sì | 
| Stato dell'agente | No | Sì | Sì | 
| Caso | Sì  | Sì | Sì | 
| Contatti | No | No | No | 
| Valutazioni dei contatti | No | Sì | Sì | 
| Indirizzi e-mail | Sì  | Sì | Sì | 
| Moduli di valutazione | Sì  | Sì | Sì | 
| Flusso | Sì  | Sì | Sì | 
| Modulo del flusso | Sì  | Sì | Sì | 
| Ore di operatività | Sì  | Sì | Sì | 
| Istanza | Sì | Sì | Sì | 
| Associazione di integrazione | No | Sì | Sì | 
| Campagna in uscita | No | Sì | Sì | 
| Numero di telefono | No | Sì | Sì | 
| Prompt | Sì  | Sì | Sì | 
| Agente della coda | No | No | Sì | 
| Queues | Sì  | Sì | Sì | 
| Connessioni rapide | No | Sì | Sì | 
| Profilo di routing | Sì  | Sì | Sì | 
| Profilo di sicurezza | Sì  | Sì | Sì | 
| Modello di attività | No | No | Sì | 
| Gruppo di distribuzione del traffico | No | Sì | Sì | 
| Destinazione del trasferimento | No | Sì | Sì | 
| Caso d’uso | No | Sì | Sì | 
| Vocabolario | No | Sì | Sì | 

*Per ulteriori informazioni sull'etichettatura, incluse le migliori pratiche, consulta [AWS Risorse per l'etichettatura](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) nella AWS Guida generale.* 

## I metadati dei tag vengono rimossi solo quando l'istanza Connect Customer viene eliminata
<a name="tag-retention"></a>

Connect Customer conserva i metadati dei tag per le risorse anche dopo l'eliminazione della risorsa. I metadati vengono conservati finché l'istanza Connect Customer è attiva. 

Questo design supporta casi d’uso storici di reportistica e controllo degli accessi (TBAC). In particolare, Connect Customer utilizza il controllo degli accessi basato su tag per le metriche storiche. Se i tag venivano rimossi contestualmente all’eliminazione di una risorsa, gli utenti che in precedenza non avevano accesso a tali risorse potrebbero inavvertitamente accedere alle metriche storiche che li coinvolgono. Il mantenimento dei tag garantisce che i limiti di accesso rimangano coerenti nel tempo. 

I tag vengono rimossi solo dopo l'eliminazione dell'intera istanza Connect Customer, a quel punto l'accesso ai dati storici non è più applicabile.

## Tag-based controllo degli accessi
<a name="tagging-access-control"></a>

Per utilizzare i tag per controllare l'accesso alle risorse all'interno AWS dei tuoi account, devi fornire le informazioni sui tag nell'elemento condition di una policy IAM. Ad esempio, per controllare l'accesso al tuo dominio Voice ID in base ai tag che gli hai assegnato, usa la chiave `aws:ResourceTag/key-name` condition per specificare quale coppia di tag chiave:valore deve essere associata al dominio, per consentirgli determinate azioni.

Per informazioni più dettagliate sul controllo degli accessi basato su tag nella console Connect Customer, consulta[Applica il controllo degli accessi basato su tag in Connect Customer](tag-based-access-control.md).

Per informazioni più dettagliate sul controllo degli accessi basato su tag in IAM, consulta [Controlling access to AWS resources using tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) nella *IAM* User Guide