**Contribuisci a migliorare questa pagina**
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à.
Per contribuire a questa guida per l'utente, scegli il GitHub link **Modifica questa pagina** nel riquadro destro di ogni pagina.
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à.
# Organizzazione delle risorse Amazon EKS con tag
È possibile utilizzare *tag* per aiutarti a gestire le risorse Amazon EKS. In questo argomento viene fornita una panoramica della funzione tag e viene illustrato come creare tag.
**Topics**
+ [Nozioni di base sui tag](#tag-basics)
+ [Assegnazione di tag alle risorse](#tag-resources)
+ [Limitazioni applicate ai tag](#tag-restrictions)
+ [Tagging delle risorse per la fatturazione](#tag-resources-for-billing)
+ [Utilizzo di tag tramite la console](#tag-resources-console)
+ [Utilizzo di tag tramite la CLI, l'API o `eksctl`](#tag-resources-api-sdk)
**Nota**
I tag sono un tipo di metadati separati dalle etichette e dalle annotazioni di Kubernetes. Per ulteriori informazioni sugli altri tipi di metadati, consulta le sezioni seguenti nella documentazione di Kubernetes:
[Etichette e selettori](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/)
[Annotazioni](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/)
## Nozioni di base sui tag
Un tag è un'etichetta che assegni a una risorsa AWS. Ciascun tag è formato da una *chiave* e da un *valore* opzionale.
Puoi utilizzare i tag per categorizzare le risorse AWS. Ad esempio, puoi categorizzarle in base a scopo, proprietario o ambiente. In presenza di un numero elevato di risorse dello stesso tipo, si possono usare i tag assegnati a una risorsa specifica per identificarla rapidamente. Ad esempio, puoi definire un set di tag per i cluster Amazon EKS per monitorare il proprietario di ogni cluster e il livello di stack. Consigliamo di definire un set coerente di chiavi di tag per ciascun tipo di risorsa. Puoi cercare e filtrare le risorse in base ai tag aggiunti.
Dopo aver aggiunto un tag, puoi modificarne le chiavi e i valori oppure rimuovere i tag da una risorsa in qualsiasi momento. Se elimini una risorsa, verranno eliminati anche tutti i tag a essa associati.
I tag non hanno alcun significato semantico per Amazon EKS e vengono interpretati rigorosamente come una stringa di caratteri. È possibile impostare il valore di un tag su una stringa vuota. Tuttavia, non è possibile impostare il valore di un tag su null. Se aggiungi un tag con la stessa chiave di un tag esistente a una risorsa specifica, il nuovo valore sovrascrive quello precedente.
Se utilizzi AWS Identity and Access Management (IAM), puoi controllare quali utenti nel tuo account AWS dispongono dell’autorizzazione per gestire i tag.
## Assegnazione di tag alle risorse
I tag sono disponibili per le risorse Amazon EKS seguenti:
+ cluster
+ gruppi di nodi gestiti
+ profili Fargate
Puoi aggiungere un tag a queste risorse utilizzando le opzioni seguenti:
+ Se utilizzi la console Amazon EKS, puoi applicare tag alle risorse nuove o esistenti in qualsiasi momento. A tale scopo, è possibile utilizzare la sheda **Tag** nella pagina della risorsa interessata. Per ulteriori informazioni, consulta [Utilizzo di tag tramite la console](#tag-resources-console).
+ Se utilizzi `eksctl`, puoi applicare i tag alle risorse quando vengono create utilizzando l’opzione `--tags`.
+ Se utilizzi l’AWS CLI, l’API Amazon EKS o un SDK AWS, è possibile applicare i tag alle nuove risorse mediante il parametro `tags` nell’operazione API rilevante. Inoltre, è possibile applicare tag a risorse utilizzando l'operazione API `TagResource`. Per ulteriori informazioni, consultare [TagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_TagResource.html).
Quando utilizzi alcune azioni per la creazione di risorse, puoi anche specificare i tag per la risorsa nello stesso momento in cui la crei. Se i tag non possono essere applicati durante la creazione di una risorsa, la risorsa non viene creata. Mediante questo meccanismo ti assicuri che le risorse a cui desideri applicare tag al momento della creazione vengono create con tag specifici o non vengono create affatto. Se aggiungi tag alle risorse al momento della creazione, non è necessario eseguire script di assegnazione di tag personalizzati dopo la creazione di una risorsa.
I tag non si propagano ad altre risorse associate alla risorsa creata. Ad esempio, i tag del profilo di Fargate non vengono propagati ad altre risorse associate a tale profilo, come i pod pianificati con esso.
## Limitazioni applicate ai tag
Ai tag si applicano le limitazioni seguenti:
+ È possibile associare un massimo di 50 tag a una risorsa.
+ Le chiavi dei tag non possono essere ripetute per una risorsa. Ogni chiave di tag deve essere univoca e può avere un solo valore.
+ Le chiavi di tag possono contenere fino a 128 caratteri in UTF-8.
+ Ogni valore può contenere fino a 256 caratteri UTF-8.
+ Se più servizi AWS e risorse utilizzano il tuo schema di tagging, limita i tipi di caratteri che usi. Alcuni servizi potrebbero avere restrizioni sui caratteri consentiti. I caratteri generalmente consentiti sono lettere, numeri, spazi e i simboli seguenti: `+` `-` `=` `.` `_` `:` `/` `@`.
+ I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
+ Non utilizzare `aws:`, ` AWS:` o qualsiasi combinazione di maiuscole o minuscole come prefisso per chiavi o valori. Questi sono prenotati solo per l'uso AWS. Non puoi modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non vengono conteggiati per il limite del numero di tag per risorsa.
## Tagging delle risorse per la fatturazione
Quando applichi i tag ai cluster Amazon EKS, puoi utilizzarli per l'allocazione dei costi nel tuo **Rapporti su costi e utilizzo**. I dati di misurazione nel **Rapporti su costi e utilizzo** mostrano l'utilizzo in tutti i processi dei cluster di Amazon EKS. Per ulteriori informazioni, consulta [AWS cost and usage report](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) nella *Guida per l’utente della fatturazione AWS*.
Il tag di allocazione dei costi generato da AWS, specificamente `aws:eks:cluster-name`, consente di suddividere i costi delle istanze Amazon EC2 per ogni singolo cluster Amazon EKS in **Cost Explorer**. Tuttavia, questo tag non rileva le spese del piano di controllo (control-plane). Il tag viene aggiunto automaticamente alle istanze Amazon EC2 che fanno parte di un cluster Amazon EKS. Questo comportamento si verifica indipendentemente dal fatto che venga eseguito il provisioning delle istanze tramite gruppi di nodi gestiti da Amazon EKS, Karpenter o direttamente con Amazon EC2. Questo tag specifico non viene conteggiato ai fini del limite di 50 tag. Per utilizzare il tag, il proprietario dell’account deve attivarlo nella Console AWS per la fatturazione o utilizzando l’API. Quando il proprietario di un account di gestione di AWS Organizations attiva il tag, questo viene attivato anche per tutti gli account membri dell’organizzazione.
Puoi organizzare le informazioni di fatturazione in base alle risorse con gli stessi valori di chiave di tag. Puoi ad esempio applicare tag a numerose risorse con un nome di applicazione specifico, quindi organizzare le informazioni di fatturazione. In questo modo, puoi visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni sulla configurazione di un report di allocazione dei costi mediante i tag, consulta [The Monthly Cost Allocation Report](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) nella *Guida per l’utente della fatturazione AWS*.
**Nota**
Se hai appena abilitato la reportistica, i dati relativi al mese corrente saranno disponibili per la visualizzazione dopo 24 ore.
**Cost Explorer** è uno strumento di reporting disponibile come parte di Piano gratuito AWS. È possibile utilizzare **Cost Explorer** per visualizzare i grafici delle tue risorse Amazon EKS degli ultimi 13 mesi. Puoi anche prevedere le spese per i prossimi tre mesi. Puoi visualizzare i modelli relativi a quanto spendi in risorse AWS nel tempo. Ad esempio, puoi utilizzarlo per identificare aree che richiedono ulteriore studio e visualizzare le tendenze che puoi utilizzare per comprendere i costi. Puoi anche specificare intervalli di tempo per i dati e visualizzare i dati temporali per mese o per giorno.
## Utilizzo di tag tramite la console
Con la console Amazon EKS è possibile gestire i tag associati ai gruppi di nodi gestiti o ai cluster nuovi o esistenti.
Quando selezioni una pagina relativa alle risorse nella console Amazon EKS, viene visualizzato l'elenco delle risorse corrispondenti. Ad esempio, se nel riquadro di navigazione sinistro si seleziona **Cluster**, nella console viene visualizzato l'elenco dei cluster Amazon EKS. Quando si seleziona una risorsa in uno di questi elenchi, (ad esempio un cluster specifico), se la risorsa supporta i tag, sarà possibile visualizzare e gestire i tag nella scheda **Tag**.
L'**Editor di tag** della Console di gestione AWS consente inoltre di gestire i tag modo unificato. Per ulteriori informazioni, consulta [Tagging your AWS resources with Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) nella *Guida per l’utente dell’editor di tag AWS*.
### Aggiunta di tag a una risorsa in fase di creazione
É possibile aggiungere tag ai gruppi di nodi gestiti, ai cluster Amazon EKS ed ai profili Fargate durante la creazione. Per ulteriori informazioni, consulta [Crea un cluster Amazon EKS.](create-cluster.md).
### Aggiunta ed eliminazione di tag in una risorsa
Puoi aggiungere o eliminare i tag associati ai cluster direttamente dalla pagina della risorsa.
1. Aprire la [Console Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Seleziona la Regione AWS da utilizzare nella barra di navigazione.
1. Nel pannello di navigazione a sinistra, seleziona **Cluster**.
1. Scegliere un cluster specifico.
1. Scegliere la scheda **Tags** (Tag) quindi scegliere **Manage tags** (Gestisci tag).
1. Nella pagina **Gestisci i tag**, aggiungi o elimina i tag in base alle esigenze.
+ Per aggiungere un tag, scegli **Add tag (Aggiungi tag)**. Specificare la chiave e il valore per ogni tag.
+ Per eliminare un tag, scegli **Rimuovi tag**.
1. Ripeti la procedura per ogni tag da aggiungere o eliminare.
1. Scegliere **Update (Aggiorna)** per terminare.
## Utilizzo di tag tramite la CLI, l'API o `eksctl`
Utilizza i seguenti comandi dell’AWS CLI oppure le operazioni API Amazon EKS per aggiungere, aggiornare, elencare ed eliminare i tag per le risorse. È possibile utilizzare solo `eksctl` per aggiungere tag e contemporaneamente creare le nuove risorse con un unico comando.
| Attività | CLI AWS | AWS Tools for Windows PowerShell | Azione API |
| --- | --- | --- | --- |
| Aggiungere sovrascrivere uno o più tag. | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/eks/tag-resource.html) | [Add-EKSResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-EKSResourceTag.html) | [TagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_TagResource.html) |
| Eliminare uno o più tag. | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/eks/untag-resource.html) | [Remove-EKSResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EKSResourceTag.html) | [UntagResource](https://docs.aws.amazon.com/eks/latest/APIReference/API_UntagResource.html) |
I seguenti esempi mostrano come aggiungere o rimuovere tag alle o dalle risorse utilizzando l’AWS CLI.
**Esempio 1: applicazione di un tag a un cluster esistente**
Il comando seguente applica un tag a un cluster esistente.
```
aws eks tag-resource --resource-arn resource_ARN --tags team=devs
```
**Esempio 2: rimozione di un tag a un cluster esistente**
Il comando seguente elimina un tag da un cluster esistente.
```
aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**Esempio 3: elencazione dei tag di una risorsa**
Il comando seguente elenca i tag associati a una risorsa esistente.
```
aws eks list-tags-for-resource --resource-arn resource_ARN
```
Quando utilizzi alcune azioni per la creazione di risorse, puoi anche specificare i tag per la risorsa nello stesso momento in cui la crei. Le seguenti operazioni supportano l'assegnazione di tag durante la creazione di una risorsa.
| Attività | CLI AWS | AWS Tools for Windows PowerShell | Azione API | eksctl |
| --- | --- | --- | --- | --- |
| Creazione di un cluster | [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/eks/create-cluster.html) | [New-EKSCluster](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSCluster.html) | [CreateCluster](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateCluster.html) | `create cluster` |
| Creazione di un gruppo di nodi gestito\$1 | [create-nodegroup](https://docs.aws.amazon.com/cli/latest/reference/eks/create-nodegroup.html) | [New-EKSNodegroup](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSNodegroup.html) | [CreateNodegroup](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateNodegroup.html) | `create nodegroup` |
| Creazione di un profilo Fargate | [create-fargate-profile](https://docs.aws.amazon.com/cli/latest/reference/eks/create-fargate-profile.html) | [New-EKSFargateProfile](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EKSFargateProfile.html) | [CreateFargateProfile.html](https://docs.aws.amazon.com/eks/latest/APIReference/API_CreateFargateProfile.html) | `create fargateprofile` |
+ Se desideri taggare anche le istanze Amazon EC2 durante la creazione di un gruppo di nodi gestito, crea il gruppo di nodi gestito utilizzando un modello di avvio. Per ulteriori informazioni, consulta [Assegnazione di tag a istanze Amazon EC2](launch-templates.md#launch-template-tagging). Se le istanze esistono già, è possibile taggare manualmente le istanze. Per ulteriori informazioni, consulta [Tagging your resources](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-resources) nella Guida per l’utente di Amazon EC2.