

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

# Contrassegna un tag a un cluster Amazon MSK
<a name="msk-tagging"></a>

Puoi assegnare i tuoi metadati sotto forma di *tag* a una risorsa Amazon MSK, ad esempio un cluster MSK. Un tag è una coppia chiave-valore che definisci per la flusso. L'utilizzo dei tag è un modo semplice ma efficace per gestire AWS le risorse e organizzare i dati, inclusi i dati di fatturazione. 

**Topics**
+ [Nozioni di base sui tag per i cluster Amazon MSK](msk-tagging-basics.md)
+ [Tieni traccia dei costi dei cluster Amazon MSK utilizzando i tag](msk-tagging-billing.md)
+ [Limitazioni applicate ai tag](msk-tagging-restrictions.md)
+ [Contrassegna le risorse utilizzando l'API Amazon MSK](msk-tagging-howto.md)

# Nozioni di base sui tag per i cluster Amazon MSK
<a name="msk-tagging-basics"></a>

Puoi utilizzare l'API di Amazon MSK per completare le attività seguenti:
+ Aggiunta di tag a una risorsa Amazon MSK.
+ Elenco dei tag per una risorsa Amazon MSK.
+ Rimozione dei tag da una risorsa Amazon MSK.

Puoi utilizzare i tag per categorizzare le risorse Amazon MSK. Ad esempio, puoi categorizzare i cluster Amazon MSK in base a scopo, proprietario o ambiente. Poiché definisci una chiave e un valore per ogni tag, puoi creare un set di categorie personalizzate per soddisfare esigenze specifiche. Ad esempio, puoi definire un set di tag che consente di monitorare i cluster in base al proprietario e all'applicazione associata. 

Di seguito sono illustrati alcuni esempi di tag:
+ `Project: Project name`
+ `Owner: Name`
+ `Purpose: Load testing` 
+ `Environment: Production` 

# Tieni traccia dei costi dei cluster Amazon MSK utilizzando i tag
<a name="msk-tagging-billing"></a>

Puoi utilizzare i tag per classificare e tenere traccia dei costi. AWS Quando applichi tag alle tue AWS risorse, inclusi i cluster Amazon MSK, il report sull'allocazione dei AWS costi include l'utilizzo e i costi aggregati per tag. Puoi organizzare i costi tra più servizi applicando tag che rappresentano categorie di business (come centri di costo, nomi di applicazioni o proprietari). Per ulteriori informazioni, consulta [Utilizzo dei tag per l'allocazione dei costi ai fini dei report di fatturazione personalizzati](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *AWS Billing User Guide (Guida per l'utente di Amazon API Gateway)*.

# Limitazioni applicate ai tag
<a name="msk-tagging-restrictions"></a>

Ai tag in Amazon MSK si applicano le limitazioni seguenti.

**Limitazioni di base**
+ Il numero massimo di tag per risorsa è 50.
+ Per le chiavi e i valori dei tag viene fatta la distinzione tra maiuscole e minuscole.
+ Non è possibile cambiare o modificare i tag di una risorsa eliminata.

**Limitazioni applicate alle chiavi di tag**
+ Ogni chiave di tag deve essere univoca. Se aggiungi un tag con una chiave già in uso, il nuovo tag sovrascrive la coppia chiave-valore esistente. 
+ Una chiave di tag non può iniziare con `aws:` perché questo prefisso è riservato per l'utilizzo da parte di AWS. AWS crea tag con questo prefisso per tuo conto, ma non puoi modificarli o eliminarli.
+ Le chiavi di tag devono avere una lunghezza compresa tra 1 e 128 caratteri Unicode.
+ Le chiavi di tag devono contenere i seguenti caratteri: lettere Unicode, cifre, spazio e i seguenti caratteri speciali: `_ . / = + - @`.

**Limitazioni applicate ai valori dei tag**
+ I valori dei tag devono avere una lunghezza compresa tra 0 e 255 caratteri Unicode.
+ I valori dei tag possono essere vuoti. In caso contrario, devono contenere i seguenti caratteri: lettere Unicode, cifre, spazio e i seguenti caratteri speciali: `_ . / = + - @`.

# Contrassegna le risorse utilizzando l'API Amazon MSK
<a name="msk-tagging-howto"></a>

Puoi utilizzare le operazioni seguenti per assegnare o rimuovere i tag da una risorsa Amazon MSK o per elencare il set di tag corrente per una risorsa:
+ [ListTagsForResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#ListTagsForResource)
+ [TagResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#TagResource)
+ [UntagResource](https://docs.aws.amazon.com//msk/1.0/apireference/tags-resourcearn.html#UntagResource)