Tagging delle risorse Amazon EC2.

Per semplificare la gestione di istanze, immagini e altre risorse Amazon EC2 puoi decidere di assegnare metadati personalizzati a ogni risorsa sotto forma di tag. I tag consentono di classificare le AWS risorse in diversi modi, ad esempio per scopo, proprietario o ambiente. Questa caratteristicaè molto utile quando hai tante risorse dello stesso tipo in quanto puoi rapidamente individuare una risorsa specifica in base ai tag assegnati. Questo argomento descrive i tag e mostra come crearli.

Nozioni di base sui tag

Un tag è un'etichetta che si assegna a una AWS risorsa. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili.

I tag consentono di classificare le AWS risorse in diversi modi, ad esempio per scopo, proprietario o ambiente. Ad esempio, puoi definire un set di tag per le istanze Amazon EC2 del tuo account e monitorare così ogni proprietario dell'istanza e il livello dello stack.

Lo schema seguente illustra il funzionamento del tagging. In questo esempio hai assegnato due tag a ciascuna istanza, un tag con la chiave Owner e un altro tag con la chiave Stack. A ogni tag è inoltre associato un valore.

Ti consigliamo di creare un set di chiavi di tag in grado di soddisfare i requisiti di ciascun tipo di risorsa. Con un set di chiavi di tag coerente, la gestione delle risorse risulta semplificata. Puoi cercare e filtrare le risorse in base ai tag aggiunti. Per ulteriori informazioni su come implementare una strategia efficace di etichettatura delle risorse, consulta il white paper sulle migliori pratiche di etichettatura. AWS

I tag non hanno alcun significato semantico per Amazon EC2 e vengono interpretati rigorosamente come una stringa di caratteri. Inoltre, i tag non vengono assegnati automaticamente alle risorse. Puoi modificare chiavi e valori di tag e rimuovere tag da una risorsa in qualsiasi momento. Puoi impostare il valore di un tag su una stringa vuota, ma non 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 elimini una risorsa, verranno eliminati anche tutti i tag associati alla risorsa.

Assegnazione di tag alle risorse

Puoi assegnare tag alla maggior parte delle risorse Amazon EC2 già esistenti nel tuo account. Nella tabella seguente sono elencate le risorse che supportano il tagging.

Se utilizzi la console Amazon EC2, puoi applicare tag alle risorse utilizzando la scheda Tag nella schermata delle risorse pertinente oppure puoi utilizzare l'Editor dei tag nella AWS Resource Groups console. Alcune schermate relative alle risorse ti permettono di specificare i tag per una risorsa quando crei la risorsa, ad esempio un tag con la chiave Name e un valore specificato. Nella maggior parte dei casi, la console applica i tag subito dopo la creazione della risorsa, anziché durante il processo di creazione. La console può organizzare le risorse in base al relativo tag Name ma questo tag non ha un significato semantico per il servizio Amazon EC2.

Se utilizzi l'API Amazon EC2, o un AWS SDK AWS CLI, puoi utilizzare l'azione API CreateTags EC2 per applicare tag alle risorse esistenti. Inoltre, alcune operazioni per la creazione di risorse ti consentono di specificare tag per una risorsa durante la sua creazione. Se i tag non possono essere applicati durante la creazione della risorsa, eseguiamo il rollback del processo di creazione della risorsa. Ciò fa sì che le risorse vengano create con i tag oppure che non vengano create affatto, nonché che nessuna risorsa sia mai sprovvista di tag. Il tagging delle risorse in fase di creazione ti permette di evitare di eseguire script di tagging personalizzati dopo la creazione delle risorse. Per ulteriori informazioni sull'abilitazione agli utenti affinché possano aggiungere tag alle risorse durante la creazione, vedere Concessione dell'autorizzazione all'applicazione di tag per le risorse durante la creazione.

La tabella seguente descrive le risorse Amazon EC2 che possono essere etichettate e le risorse che possono essere taggate al momento della creazione utilizzando l'API Amazon EC2, o un AWS CLI SDK. AWS

Puoi creare tag per istanze, volumi, grafica elastica, interfacce di rete e richieste di istanze spot in fase di creazione utilizzando la procedura guidata di avvio istanza di Amazon EC2 nella console Amazon EC2. Puoi associare tag a volumi EBS in fase di creazione utilizzando la schermata Volumi o a snapshot EBS tramite la schermata Snapshots. In alternativa, usa le API Amazon EC2 che creano risorse (ad esempio RunInstances) per applicare i tag durante la creazione della risorsa.

Puoi applicare autorizzazioni basate su tag a livello di risorsa nelle policy IAM alle operazioni dell'API Amazon EC2 che supportano il tagging in fase di creazione per implementare un controllo granulare sugli utenti e sui gruppi che associano tag alle risorse in fase di creazione. Le risorse vengono adeguatamente protette a partire dal momento della creazione, ovvero i tag vengono applicati subito alle risorse. Pertanto qualsiasi autorizzazione basata su tag a livello di risorsa che controlla l'uso delle risorse risulta immediatamente valida. Le risorse possono essere monitorate e segnalate con maggiore precisione. Puoi applicare l'uso del tagging alle nuove risorse e controllare quali chiavi e valori di tag sono impostati per le risorse.

Puoi inoltre applicare autorizzazioni a livello di risorsa alle operazioni CreateTags e DeleteTags dell'API Amazon EC2 nelle policy IAM per controllare quali chiavi e valori di tag sono impostati sulle risorse esistenti. Per ulteriori informazioni, consulta Esempio: aggiunta di tag alle risorse.

Per ulteriori informazioni sul tagging delle risorse per la fatturazione, consulta Utilizzo di tag per l'allocazione dei costi nella Guida per l'utente di AWS Billing .

Limitazioni applicate ai tag

Si applicano le seguenti limitazioni di base ai tag:

Non puoi interrompere, arrestare o eliminare una risorsa solo sulla base dei relativi tag. Devi specificare il relativo identificatore. Ad esempio, per eliminare gli snapshot associato a una chiave di tag denominata DeleteMe, devi utilizzare l'operazione DeleteSnapshots con gli identificatori di risorsa degli snapshot, ad esempio snap-1234567890abcdef0.

Quando tagghi risorse pubbliche o condivise, i tag che assegni sono disponibili solo per il tuo AWS account; nessun altro AWS account avrà accesso a quei tag. Per il controllo dell'accesso alle risorse condivise basato su tag, ogni AWS account deve assegnare il proprio set di tag per controllare l'accesso alla risorsa.

Non puoi associare tag a tutte le risorse. Per ulteriori informazioni, consulta Supporto del tagging per le risorse Amazon EC2.

Tag e gestione degli accessi

Se utilizzi AWS Identity and Access Management (IAM), puoi controllare quali utenti del tuo AWS account sono autorizzati a creare, modificare o eliminare i tag. Per ulteriori informazioni, consulta Concessione dell'autorizzazione all'applicazione di tag per le risorse durante la creazione.

Puoi inoltre utilizzare i tag delle risorse per implementare il controllo basato sugli attributi (ABAC). Puoi creare le policy IAM che consentono operazioni basate sui tag per la risorsa. Per ulteriori informazioni, consulta Controllo dell'accesso alle risorse EC2 mediante i tag delle risorse.

Tagging delle risorse per la fatturazione

Puoi utilizzare i tag per organizzare la AWS fattura in modo che rifletta la tua struttura dei costi. A tale scopo, registrati per ricevere una fattura sul tuo AWS account con i valori chiave dell'etichetta inclusi. Per ulteriori informazioni sulla configurazione di un report di allocazione dei costi mediante i tag, consulta Report di allocazione dei costi mensili nella Guida per l'utente di AWS Billing . Per visualizzare il costo delle risorse combinate, 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 per visualizzare il costo totale dell'applicazione in più servizi. Per ulteriori informazioni, consulta Utilizzo dei tag per l'allocazione dei costi nella Guida per l'utente di AWS Billing .

I tag di allocazione dei costi possono indicare quali risorse contribuiscono ai costi, ma eliminare o disattivare le risorse non sempre riduce i costi. Ad esempio, i dati di snapshot a cui fa riferimento un altro snapshot vengono conservati anche se viene eliminato lo snapshot contenente i dati originali. Per ulteriori informazioni, consulta Volumi e snapshot di Amazon Elastic Block Store nella Guida per l'utente di AWS Billing .

Utilizzo di tag tramite la console

Puoi utilizzare la console di Amazon EC2 per visualizzare i tag di una singola risorsa e per applicare o rimuovere i tag da una risorsa alla volta.

Puoi utilizzare il Tag Editor nella AWS Resource Groups console per visualizzare i tag di tutte le tue risorse Amazon EC2 in tutte le regioni. Puoi visualizzare i tag per risorsa e per tipo di risorsa e vedere quali tipi di risorsa sono associati a un tag specifico. Puoi applicare o rimuovere i tag da più risorse e più tipi contemporaneamente. Il Tag Editor offre un sistema centrale e unificato per creare e gestire i tuoi tag. Per ulteriori informazioni, consulta la Tagging AWS Resources User Guide.

Visualizzazione dei tag

Nella console Amazon EC2 puoi visualizzare i tag di una singola risorsa. Per visualizzare i tag di tutte le tue risorse, usa il Tag Editor nella console AWS Resource Groups .

Visualizza i tag di una singola risorsa

Quando selezioni una pagina relativa alle risorse nella console Amazon EC2, viene visualizzato l'elenco delle risorse corrispondenti. Ad esempio, se nel riquadro di navigazione selezioni Instances (Istanze), nella console vengono visualizzate le istanze Amazon EC2. Quando selezioni una risorsa in uno di questi elenchi, ad esempio un'istanza, se la risorsa supporta i tag, potrai visualizzare e gestire i relativi tag. Nella maggior parte delle pagine delle risorse, è possibile visualizzare i tag scegliendo la scheda Tags (Tag).

All'elenco di risorse puoi aggiungere una colonna in cui visualizzare tutti i valori dei tag con la stessa chiave. Questa colonna ti permette di ordinare e filtrare l'elenco delle risorse in base al tag.

Visualizzazione dei tag per più risorse

Puoi visualizzare i tag su più risorse utilizzando il Tag Editor nella console AWS Resource Groups. Per ulteriori informazioni, consulta la Tagging AWS Resources User Guide.

Aggiunta ed eliminazione di tag in una singola risorsa

Puoi gestire i tag per una singola risorsa direttamente dalla pagina della risorsa interessata.

Aggiunta ed eliminazione di tag per più risorse

Aggiunta di un tag all'avvio di un'istanza

Filtrare un elenco di risorse per tag

Puoi filtrare l'elenco di risorse in base a uno o più chiavi e valori di tag.

Per ulteriori informazioni sull'uso dei filtri nella console di Amazon EC2, consulta Elencare e filtrare le risorse.

Per filtrare più risorse in più regioni per tag utilizzando il Tag Editor.

Puoi utilizzare l'editor di tag nella console AWS Resource Groups per filtrare più risorse in più regioni per tag. Per ulteriori informazioni, consulta Trovare risorse cui applicare un tag nella Guida all'uso delle risorse AWS dei Tag.

Utilizzo dei tag tramite la riga di comando

È possibile aggiungere tag a molte risorse EC2 al momento della creazione, utilizzando il parametro specifiche tag per il comando create. È possibile visualizzare i tag di una risorsa utilizzando il comando describe per la risorsa. È inoltre possibile aggiungere, aggiornare o eliminare tag per le risorse esistenti utilizzando i comandi seguenti.

Aggiunta di tag alla creazione di risorse

I seguenti esempi mostrano come applicare i tag quando crei le risorse.

aws ec2 run-instances \
    --image-id ami-abc12345 \
    --count 1 \
    --instance-type t2.micro \
    --key-name MyKeyPair \
    --subnet-id subnet-6e7f829e \
    --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]' 

aws ec2 run-instances \
    --image-id ami-abc12345 \
    --count 1 \
    --instance-type t2.micro \
    --key-name MyKeyPair \
    --subnet-id subnet-6e7f829e \
    --tag-specifications 'ResourceType=instance,Tags=[{Key=cost-center,Value=cc123}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]' 

aws ec2 create-volume \
    --availability-zone us-east-1a \
    --volume-type gp2 \
    --size 80 \
    --tag-specifications 'ResourceType=volume,Tags=[{Key=purpose,Value=production},{Key=cost-center,Value=cc123}]'

Aggiunta di tag a una risorsa esistente

Negli esempi seguenti viene illustrato come aggiungere tag a una risorsa esistente utilizzando il comando create-tags.

aws ec2 create-tags \
    --resources ami-78a54011 \
    --tags Key=Stack,Value=production

aws ec2 create-tags \
    --resources ami-1a2b3c4d i-1234567890abcdef0 \
    --tags Key=webserver,Value=  Key=stack,Value=Production

aws ec2 create-tags \
    --resources i-1234567890abcdef0 \
    --tags 'Key="[Group]",Value=test'

aws ec2 create-tags ^
    --resources i-1234567890abcdef0 ^
    --tags Key=\"[Group]\",Value=test

aws ec2 create-tags `
    --resources i-1234567890abcdef0 `
    --tags 'Key=\"[Group]\",Value=test'

Descrizione delle risorse con tag

Negli esempi seguenti viene illustrato come usare i filtri con describe-instances per visualizzare le istanze con tag specifici. Tutti i comandi EC2 describe utilizzano questa sintassi per filtrare per tag in un singolo tipo di risorsa. In alternativa, è possibile utilizzare il comando describe-tags per filtrare per tag tra i tipi di risorse EC2.

aws ec2 describe-instances \
    --filters Name=tag-key,Values=Stack

aws ec2 describe-instances \
    --filters Name=tag:Stack,Values=production

aws ec2 describe-instances \
    --filters Name=tag-value,Values=production

aws ec2 describe-tags \
    --filters Name=key,Values=Stack Name=value,Values=Test

Utilizzo dei tag dell'istanza nei metadati dell'istanza

È possibile accedere ai tag di un'istanza dai metadati dell'istanza. Accedendo ai tag dai metadati dell'istanza non è più necessario utilizzare Chiamate API DescribeInstances o DescribeTags per recuperare le informazioni sui tag, ciò riduce le transazioni API al secondo e consente al recupero dei tag di scalare il numero di istanze che si controllano. Inoltre, i processi locali in esecuzione su un'istanza possono visualizzare le informazioni sui tag dell'istanza direttamente dai metadati dell'istanza.

Per impostazione predefinita, i tag non sono disponibili dai metadati dell'istanza; è necessario consentire esplicitamente l'accesso. È possibile consentire l'accesso all'avvio dell'istanza o dopo l'avvio su un'istanza in esecuzione o interrotta. È inoltre possibile consentire l'accesso ai tag specificandolo in un modello di avvio. Le istanze avviate utilizzando il modello consentono l'accesso ai tag nei metadati dell'istanza.

Se aggiungi o rimuovi un tag di istanza, i metadati dell'istanza vengono aggiornati mentre l'istanza è in esecuzione, senza doverla arrestare e poi avviare.

Per consentire l'accesso ai tag nei metadati delle istanze

Per impostazione predefinita, non è possibile accedere ai tag dell'istanza nei metadati dell'istanza. Per ogni istanza, è necessario consentire l'accesso esplicitamente utilizzando uno dei metodi descritti di seguito.

Per consentire l'accesso ai tag nei metadati dell'istanza all'avvio utilizzando AWS CLI

Utilizzare il comando run-instances e impostare InstanceMetadataTags a enabled.

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type c3.large \
    ...
    --metadata-options "InstanceMetadataTags=enabled"

Per consentire l'accesso ai tag nei metadati dell'istanza su un'istanza in esecuzione o interrotta utilizzando AWS CLI

Utilizzare il comando modify-instance-metadata-options e impostare il parametro --instance-metadata-tags su enabled.

aws ec2 modify-instance-metadata-options \
    --instance-id i-123456789example \
    --instance-metadata-tags enabled

Disattivazione dell'accesso ai metadati dell'istanza

Per disattivare l'accesso ai tag dell'istanza nei metadati dell'istanza, utilizzare uno dei metodi descritti di seguito. Non è necessario disattivare l'accesso ai tag di istanza sui metadati delle istanze all'avvio perché è disattivato per impostazione predefinita.

Per disattivare l'accesso ai tag nei metadati delle istanze, utilizzate il AWS CLI

Utilizzare il comando modify-instance-metadata-options e impostare il parametro --instance-metadata-tags su disabled.

aws ec2 modify-instance-metadata-options \
    --instance-id i-123456789example \
    --instance-metadata-tags disabled

Verifica del consenso dell'accesso ai tag nei metadati dell'istanza

Per ogni istanza, puoi utilizzare la console Amazon EC2 o AWS CLI verificare se è consentito l'accesso ai tag dell'istanza dai metadati dell'istanza.

Per verificare se l'accesso ai tag nei metadati dell'istanza è consentito, utilizza il AWS CLI

Utilizza il comando describe-instances e specifica l'ID istanza.

aws ec2 describe-instances \
    --instance-ids i-1234567890abcdef0

L'output di esempio seguente è stato troncato per motivi di spazio. Il parametro "InstanceMetadataTags" indica se i tag nei metadati delle istanze sono consentiti. Se il valore è enabled, i tag nei metadati dell'istanza sono consentiti. Se il valore è disabled, i tag nei metadati dell'istanza non sono consentiti.

{
    "Reservations": [
        {
            "Groups": [],
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "ami-0abcdef1234567890",
                    "InstanceId": "i-1234567890abcdef0",
			...
			
			"MetadataOptions": {
			"State": "applied",
			"HttpTokens": "optional",
			"HttpPutResponseHopLimit": 1,
			"HttpEndpoint": "enabled",
			"HttpProtocolIpv6": "disabled",
			"InstanceMetadataTags": "enabled"
			},
			...

Recupero dei tag dai metadati dell'istanza

Se i tag dell'istanza sono consentiti nei metadati dell'istanza, la categoria tags/instance è accessibile dai metadati dell'istanza. Per esempi su come recuperare i tag dai metadati dell'istanza, consultare Ottenere i tag dell'istanza per un'istanza.

Aggiungere tag a una risorsa utilizzando CloudFormation

Con i tipi di risorse Amazon EC2, è possibile specificare i tag utilizzando una proprietà Tags o TagSpecifications.

I seguenti esempi aggiungono il tag Stack=Production all'AWS::EC2::Instanceutilizzo della sua Tags proprietà.

Tags:
  - Key: "Stack"
    Value: "Production"

"Tags": [
    {
        "Key": "Stack",
        "Value": "Production"
    }
]

Gli esempi seguenti aggiungono il tag Stack=Production a AWS::EC2::LaunchTemplate LaunchTemplateData utilizzando la relativa TagSpecifications proprietà.

TagSpecifications:
  - ResourceType: "instance"
    Tags:
    - Key: "Stack"
      Value: "Production"

"TagSpecifications": [
    {
        "ResourceType": "instance",
        "Tags": [
            {
                "Key": "Stack",
                "Value": "Production"
            }
        ]
    }
]