Etichettare le risorse Amazon ECS

Per aiutarti a gestire le tue ECS risorse Amazon, puoi facoltativamente assegnare i tuoi metadati a ciascuna risorsa utilizzando i tag. Ciascun tag è formato da una chiave e da un valore facoltativo.

Puoi utilizzare i tag per classificare le tue ECS risorse Amazon in diversi modi, ad esempio per scopo, proprietario o ambiente. Questa funzione è utile quando si dispone di numerose risorse dello stesso tipo. Puoi identificare velocemente una risorsa specifica in base ai tag a questa assegnati. Ad esempio, puoi definire un set di tag per le istanze di ECS container Amazon del tuo account. Questo ti aiuta a monitorare il proprietario dell'istanza e il livello dello stack.

Puoi utilizzare i tag per i report su costi e utilizzo. Puoi utilizzare questi report per analizzare il costo e l'utilizzo delle tue ECS risorse Amazon. Per ulteriori informazioni, consulta Report ECS sull'utilizzo di Amazon.

avvertimento

Ce ne sono molti APIs che restituiscono le chiavi dei tag e i relativi valori. Negare l'accesso a DescribeTags non nega automaticamente l'accesso ai tag restituiti da altri. APIs Come da best practice, è consigliabile non includere dati sensibili nei tag.

Ti consigliamo di creare un set di chiavi di tag in grado di soddisfare i requisiti di ciascun tipo di risorsa. Tramite un set di chiavi di tag coerente la gestione delle risorse risulta notevolmente semplificata. Puoi cercare e filtrare le risorse in base ai tag aggiunti.

I tag non hanno alcun significato semantico per Amazon ECS e vengono interpretati rigorosamente come una stringa di caratteri. Puoi modificare chiavi e valori di tag e rimuovere tag da una risorsa in qualsiasi momento. È possibile impostare il valore di un tag su una stringa vuota, ma non su null. Se a una risorsa specifica aggiungi un tag con la stessa chiave di un tag esistente, il nuovo valore sovrascriverà quello precedente. Quando elimini una risorsa, vengono eliminati anche tutti i tag relativi alla risorsa.

Se usi AWS Identity and Access Management (IAM), puoi controllare quali utenti del tuo AWS account sono autorizzati a gestire i tag.

Assegnazione di tag alle risorse

Esistono diversi modi in cui ECS le attività, i servizi, le definizioni delle attività e i cluster di Amazon vengono etichettati:

• Un utente tagga manualmente una risorsa utilizzando Amazon AWS Management Console ECS API AWS CLI, o un AWS SDK.

• Un utente crea un servizio o esegue un'attività autonoma e seleziona l'opzione Amazon ECS -managed tags.

  Amazon contrassegna ECS automaticamente tutte le attività appena avviate. Per ulteriori informazioni, consulta Tag ECS gestiti da Amazon.

• Un utente crea una risorsa utilizzando la console. La console assegna automaticamente i tag alle risorse.

  Questi tag vengono AWS CLI restituiti nelle AWS SDK risposte e vengono visualizzati nella console. Non è possibile modificare o eliminare questi tag.

  Per informazioni sui tag aggiunti, consulta la colonna Tag aggiunti automaticamente dalla console nella tabella Tagging support for Amazon ECS resources.

Se specifichi dei tag quando crei una risorsa e i tag non possono essere applicati, Amazon ECS ripristina il processo di creazione. 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. L'aggiunta di tag alle risorse in fase di creazione consente di evitare di eseguire script di tagging personalizzati dopo la creazione delle risorse.

La tabella seguente descrive le ECS risorse Amazon che supportano il tagging.

Risorsa	Supporta tag	Supporta la propagazione di tag	Tag aggiunti automaticamente dalla console
ECSAttività Amazon	Sì	Sì, dalla definizione di attività.	Chiave: aws:ecs:clusterName Value (Valore): cluster-name
ECSServizi Amazon	Sì	Sì, dalla definizione di attività o dal servizio alle attività del servizio.	Chiave: ecs:service:stackId Value arn:aws:cloudformation:arn
Set di ECS attività Amazon	Sì	No	N/D
Definizioni ECS delle attività di Amazon	Sì	No	Chiave: ecs:taskDefinition:createdFrom Value (Valore): ecs-console-v2
ECSCluster Amazon	Sì	No	Chiave: aws:cloudformation:logical-id Value (Valore): ECSCluster Chiave: aws:cloudformation:stack-id Value (Valore): arn:aws:cloudformation:arn Chiave: aws:cloudformation:stack-name Value (Valore): ECS-Console-V2-Cluster-EXAMPLE
Istanze di ECS container Amazon	Sì	Sì, dall'EC2istanza Amazon. Per ulteriori informazioni, consulta Aggiungere tag a un'istanza di ECS container Amazon.	N/D
Istanze ECS esterne Amazon	Sì	No	N/D
Fornitore ECS di capacità Amazon	Sì. Non è possibile applicare tag ai provider di capacità predefiniti FARGATE e FARGATE_SPOT.	No	N/D

Applicazione di tag alle risorse durante la creazione

Le seguenti risorse supportano l'etichettatura alla creazione tramite Amazon ECS API AWS CLI, oppure AWS SDK:

• ECSAttività Amazon

• ECSServizi Amazon

• Definizione ECS delle attività di Amazon

• Set di ECS attività Amazon

• ECSCluster Amazon

• Istanze di ECS container Amazon

• Fornitori ECS di capacità Amazon

Amazon ECS ha la possibilità di utilizzare l'autorizzazione all'etichettatura per la creazione di risorse. Quando Account AWS è configurato per l'autorizzazione all'etichettatura, gli utenti devono disporre delle autorizzazioni per le azioni che creano la risorsa, ad esempio. ecsCreateCluster Se specifichi i tag nell'azione di creazione della risorsa, AWS esegue un'autorizzazione aggiuntiva per verificare se gli utenti o i ruoli dispongono delle autorizzazioni per creare tag. Pertanto, devi concedere le autorizzazioni esplicite per utilizzare l'operazione ecs:TagResource. Per ulteriori informazioni, consulta Concessione dell'autorizzazione all'assegnazione di tag alle risorse al momento della creazione. Per informazioni su come configurare l'opzione, consulta. Autorizzazione all'assegnazione di tag

Restrizioni

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 possono contenere fino a 128 caratteri in UTF -8.

• I valori possono avere una lunghezza massima di 256 caratteri in UTF -8.

• Se più risorse Servizi AWS e 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 è possibile utilizzare aws:, AWS: o qualsiasi combinazione di maiuscole o minuscole di un tale prefisso per chiavi o valori. Questi sono riservati solo all' AWS uso. Non è possibile modificare né eliminare le chiavi o i valori di tag con tale prefisso. I tag con questo prefisso non rientrano nel tuo tags-per-resource limite.

Tag ECS gestiti da Amazon

Quando utilizzi i tag ECS gestiti da Amazon, Amazon contrassegna ECS automaticamente tutte le attività appena avviate e tutti i EBS volumi Amazon collegati alle attività con le informazioni sul cluster e i tag di definizione delle attività aggiunti dall'utente o i tag di servizio. Di seguito vengono descritti i tag aggiunti:

• Attività autonome: un tag con una Chiave come aws:ecs:clusterName e un Valore impostato sul nome del cluster. Tutti i tag di definizione delle attività aggiunti dagli utenti. Un EBS volume Amazon collegato a un'attività autonoma riceverà il tag con una chiave come aws:ecs:clusterName e un valore impostato sul nome del cluster. Per ulteriori informazioni sull'etichettatura dei EBS volumi Amazon, consulta Tagging Amazon EBS Volumes.

• Attività che fanno parte di un servizio: un tag con una Chiave come aws:ecs:clusterName e un Valore impostato sul nome del cluster. Un tag con una Chiave come aws:ecs:serviceName e un Valore impostato sul nome del servizio. Tag da una delle risorse seguenti:

  • Definizioni delle attività: tutti i tag di definizione delle attività aggiunti dagli utenti.

  • Servizi: tutti i tag di servizio aggiunti dagli utenti.

    Un EBS volume Amazon collegato a un'attività che fa parte di un servizio riceverà un tag con una chiave come aws:ecs:clusterName e un valore impostati sul nome del cluster e un tag con una chiave come aws:ecs:serviceName e un valore impostati sul nome del servizio. Per ulteriori informazioni sull'etichettatura dei EBS volumi Amazon, consulta Tagging Amazon EBS Volumes.

Per questa funzionalità sono richieste le seguenti opzioni:

• Devi attivare i nuovi formati Amazon Resource Name (ARN) e Resource Identifier (ID). Per ulteriori informazioni, consulta Nomi di risorse Amazon (ARNs) e IDs.

• Quando utilizzi il APIs per creare un servizio o eseguire un'attività, devi enableECSManagedTags impostarlo su true for run-task ecreate-service. Per ulteriori informazioni, consulta create-service e run-task nella Guida di riferimento.AWS Command Line Interface API

• Amazon ECS utilizza tag gestiti per determinare quando alcune funzionalità sono abilitate, ad esempio Cluster Auto Scaling. Ti consigliamo di non modificare manualmente i tag in modo che Amazon ECS possa gestire efficacemente le funzionalità.

Utilizza i tag per la fatturazione

AWS fornisce uno strumento di reporting chiamato Cost Explorer che puoi utilizzare per analizzare il costo e l'utilizzo delle tue ECS risorse Amazon.

Utilizza Cost Explorer per visualizzare i grafici relativi all'utilizzo e ai costi. Puoi visualizzare i dati fino agli ultimi 13 mesi e prevedere le spese dei prossimi tre mesi. Puoi utilizzare Cost Explorer per 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.

Puoi utilizzare tag ECS gestiti da Amazon o tag aggiunti dall'utente per il tuo report su costi e utilizzo. Per ulteriori informazioni, consulta Report ECS sull'utilizzo di Amazon.

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

Inoltre, puoi attivare Split Cost Allocation Data per ottenere dati a livello di attività e utilizzo della memoria nei report sui costi CPU e sull'utilizzo della memoria. Per ulteriori informazioni, consulta Report di costi e utilizzo a livello di attività.

Nota

Se hai attivato il report, i dati relativi al mese corrente saranno disponibili per la visualizzazione entro 24 ore.