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à.
# Aggiunta di tag alle risorse Amazon ECS
Per semplificare la gestione delle risorse Amazon ECS, è possibile assegnare metadati personalizzati a ciascuna risorsa sotto forma di *tag*. Ciascun *tag* è formato da una *chiave* e da un *valore* facoltativo.
Puoi utilizzare i tag per categorizzare le risorse Amazon ECS in vari 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 del container Amazon ECS 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 risorse di Amazon ECS. Per ulteriori informazioni, consulta [Report di utilizzo di Amazon ECS](usage-reports.md).
**avvertimento**
Ce ne sono molti APIs che restituiscono le chiavi dei tag e i loro 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, verranno eliminati anche tutti i tag a essa associati.
Se utilizzi 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 per assegnare tag ad attività, servizi, definizioni di attività e cluster Amazon ECS:
+ Un utente tagga manualmente una risorsa utilizzando l' Console di gestione AWS API Amazon ECS AWS CLI, o un AWS SDK.
+ Un utente crea un servizio o esegue un'attività autonoma e seleziona l'opzione dei tag gestiti da Amazon ECS.
Amazon ECS assegna automaticamente i tag a tutte le attività appena avviate. Per ulteriori informazioni, consulta [Tag gestiti da Amazon ECS](#managed-tags).
+ Un utente crea una risorsa utilizzando la console. La console assegna automaticamente i tag alle risorse.
Questi tag vengono restituiti nelle AWS CLI risposte e AWS SDK 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 **Supporto del tagging per le risorse Amazon ECS**.
Se specifichi dei tag quando crei una risorsa e i tag non possono essere applicati, Amazon ECS esegue il rollback del 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 risorse Amazon ECS che supportano il tagging.
| Risorsa | Supporta tag | Supporta la propagazione di tag | Tag aggiunti automaticamente dalla console |
| --- | --- | --- | --- |
| Attività di Amazon ECS | Sì | Sì, dalla definizione di attività. | Chiave: aws:ecs:clusterName *Value (Valore)*: `cluster-name` |
| Servizi Amazon ECS | Sì | Sì, dalla definizione di attività o dal servizio alle attività del servizio. | Chiave: ecs:service:stackId *Value* `arn:aws:cloudformation:arn` |
| Set di processi di Amazon ECS | Sì | No | N/D |
| Definizione dei processi di Amazon ECS | Sì | No | Chiave: ecs:taskDefinition:createdFrom *Value (Valore)*: `ecs-console-v2` |
| Cluster Amazon ECS | 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 container di Amazon ECS | Sì | Sì, dall'istanza Amazon EC2. Per ulteriori informazioni, consulta [Aggiunta di tag a un'istanza di container di Amazon EC2 per Amazon ECS](instance-details-tags.md). | N/D |
| Istanze esterne di Amazon ECS | Sì | No | N/D |
| Provider di capacità Amazon ECS | Sì. Non è possibile applicare tag ai provider di capacità predefiniti `FARGATE` e `FARGATE_SPOT`. | Sì, solo dai fornitori di capacità per le istanze gestite da Amazon ECS. Puoi propagare i tag dal provider di capacità per le istanze gestite da Amazon ECS a tutte le risorse gestite dal provider, come le istanze Amazon EC2, i modelli di avvio, le interfacce di rete elastiche e i volumi. | N/D |
## Applicazione di tag alle risorse durante la creazione
Le seguenti risorse supportano l'etichettatura alla creazione utilizzando l'API Amazon ECS o AWS CLI AWS SDK:
+ Attività di Amazon ECS
+ Servizi Amazon ECS
+ Definizione dell’attività di Amazon ECS
+ Set di processi di Amazon ECS
+ Cluster Amazon ECS
+ Istanze di container di Amazon ECS
+ Fornitori di capacità Amazon ECS
Amazon ECS offre la possibilità di utilizzare l'autorizzazione all'assegnazione di tag per la creazione di risorse. Quando l' Account AWS è configurato per l'autorizzazione dei tag, gli utenti devono disporre delle autorizzazioni per le azioni che creano la risorsa, come `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](supported-iam-actions-tagging.md). Per ulteriori informazioni su come configurare l'opzione, consulta [Autorizzazione all'assegnazione di tag](ecs-account-settings.md#tag-resources-setting).
## 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 di tag possono contenere fino a 128 caratteri in UTF-8.
+ Ogni valore può contenere fino a 256 caratteri 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 gestiti da Amazon ECS
Quando utilizzi i tag gestiti da Amazon ECS, il servizio assegna automaticamente a tutte le attività appena avviate e a tutti i volumi Amazon EBS associati alle attività i tag relativi alle 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 volume Amazon EBS 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 sulla menzione di volumi Amazon EBS, consultare [Utilizzo dei tag per i volumi Amazon EBS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging).
+ 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 volume Amazon EBS associato a un'attività che fa parte di un servizio riceverà un tag con una *Chiave* come `aws:ecs:clusterName` e un *Valore* impostato sul nome del cluster, nonché un tag con una *Chiave* come `aws:ecs:serviceName` e un *Valore* impostato sul nome del servizio. Per ulteriori informazioni sulla menzione di volumi Amazon EBS, consultare [Utilizzo dei tag per i volumi Amazon EBS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging).
Per questa funzionalità sono richieste le seguenti opzioni:
+ Devi scegliere esplicitamente i nuovi formati per il nome della risorsa Amazon (ARN) e l'identificatore di risorsa (ID). Per ulteriori informazioni, consulta [Nomi di risorse Amazon (ARNs) e IDs](ecs-account-settings.md#ecs-resource-ids).
+ Quando si utilizza il APIs per creare un servizio o eseguire un'attività, è necessario `enableECSManagedTags` impostare su `true` for `run-task` e`create-service`. Per ulteriori informazioni, consulta [create-service](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) e [run-task](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) nella *Documentazione di riferimento delle API AWS Command Line Interface *.
+ Amazon ECS utilizza tag gestiti per determinare quando alcune funzionalità sono abilitate, ad esempio il dimensionamento automatico del cluster. Consigliamo di non modificare manualmente i tag in modo che Amazon ECS possa gestire efficacemente le funzionalità.
## Uso dei tag per la risoluzione dei problemi
AWS fornisce uno strumento di reporting chiamato Cost Explorer che puoi utilizzare per analizzare il costo e l'utilizzo delle tue risorse Amazon ECS.
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 i tag gestiti da Amazon ECS oppure tag aggiunti dall'utente per il tuo report su costi e utilizzo. Per ulteriori informazioni, consulta [Report di utilizzo di Amazon ECS](usage-reports.md).
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](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) nella *Guida per l'utente di AWS Billing *.
Inoltre, puoi attivare *Dati di ripartizione dei costi* per inserire i dati sull'utilizzo della CPU e della memoria a livello di attività in Report di costi utilizzo. Per ulteriori informazioni, consulta [Report di costi e utilizzo a livello di attività](usage-reports.md#task-cur).
**Nota**
Se hai attivato il report, i dati relativi al mese corrente saranno disponibili per la visualizzazione entro 24 ore.
# Aggiunta di tag alle risorse Amazon ECS
Puoi applicare tag ad attività, servizi, definizioni delle attività o cluster nuovi o esistenti. Per informazioni sull'etichettatura delle istanze dei container, consulta. [Aggiunta di tag a un'istanza di container di Amazon EC2 per Amazon ECS](instance-details-tags.md)
**avvertimento**
Non aggiungere Informazioni personali di identificazione (PII) o altre informazioni riservate o sensibili nei tag. I tag sono accessibili a molti AWS servizi, inclusa la fatturazione. I tag non sono destinati ad essere utilizzati per dati privati o sensibili.
Le risorse seguenti consentono di specificare i tag al momento della creazione della risorsa.
| Operazione | Console | AWS CLI | Operazione API |
| --- | --- | --- | --- |
| Esegui una o più operazioni. | [Esecuzione di un'applicazione come attività Amazon ECS](standalone-task-create.md) | [run-task](https://docs.aws.amazon.com/cli/latest/reference/ecs/run-task.html) | [RunTask](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) |
| Crea un servizio. | [Creazione di un'implementazione di aggiornamenti continui di Amazon ECS](create-service-console-v2.md) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-service.html) | [CreateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) |
| Crea un set di attività. | [Implementare i servizi Amazon ECS utilizzando un controller di terze parti](deployment-type-external.md) | [create-task-set](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-task-set.html) | [CreateTaskSet](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html) |
| Registra una definizione di attività. | [Creazione di una definizione di attività di Amazon ECS attraverso la nuova console](create-task-definition.md) | [register-task-definition](https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html) | [RegisterTaskDefinition](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RegisterTaskDefinition.html) |
| Crea un cluster. | [Creazione di un cluster Amazon ECS per i carichi di lavoro Fargate](create-cluster-console-v2.md) | [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-cluster.html) | [CreateCluster](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html) |
| Esegui una o più istanze di container. | [Avvio di un'istanza di container Linux di Amazon ECS](launch_container_instance.md) | [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) | [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) |
| Crea un provider di capacità per le istanze gestite da Amazon ECS. | [Creazione di un provider di capacità per le istanze gestite da Amazon ECS](create-capacity-provider-managed-instances.md) | [create-capacity-provider](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-capacity-provider.html) | [CreateCapacityProvider](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html) |
## Assegnare tag alle risorse esistenti (console Amazon ECS)
Puoi aggiungere o eliminare i tag associati a cluster, servizi, attività e definizioni di attività direttamente dalla pagina della risorsa.
**Modifica di un tag per una singola risorsa**
1. Apri la console alla [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).
1. Dalla barra di navigazione, seleziona l'opzione Regione AWS da utilizzare.
1. Nel riquadro di navigazione, seleziona un tipo di risorsa (ad esempio **Cluster**).
1. Seleziona la risorsa dall'elenco di risorse, scegli la scheda **Tags** (Tag), quindi seleziona **Manage tags** (Gestisci tag).
1. Configura i tag.
[Aggiungi un tag] Scegli **Add tag** (Aggiungi tag), quindi effettuare le seguenti operazioni:
+ In **Chiave**, immetti il nome della chiave.
+ In **Valore**, immetti il valore della chiave.
1. Scegli **Save** (Salva).
## Assegnazione di tag a risorse AWS CLI esistenti
Puoi aggiungere o sovrascrivere uno o più tag utilizzando AWS CLI o un'API.
**Nota**
Puoi utilizzare gli endpoint del servizio dual-stack per interagire con Amazon ECS da AWS CLI, SDKs e l'API Amazon ECS su entrambi e. IPv4 IPv6 Per ulteriori informazioni, consulta [Utilizzo degli endpoint dual-stack Amazon ECS](dual-stack-endpoint.md).
+ AWS CLI [- tag-risorsa](https://docs.aws.amazon.com/cli/latest/reference/ecs/tag-resource.html)
+ Azione API - [TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html)
# Tag per le istanze gestite da Amazon ECS
Le istanze gestite di Amazon ECS supportano una combinazione di tag personalizzati e tag aggiunti AWS che possono essere utilizzati per l'ottimizzazione dei costi. Per ulteriori informazioni sull'utilizzo dei tag per la risoluzione dei problemi, consulta [Uso dei tag per la risoluzione dei problemi](ecs-using-tags.md#tag-resources-for-billing).
## Tag aggiunti da AWS
AWS aggiunge i seguenti tag a ogni istanza gestita di Amazon ECS creata dal provider di capacità:
+ Amazon ECS assegna automaticamente i tag riservati `AmazonECSCreated` e `AmazonECSManaged` alle istanze gestite da Amazon ECS.
+ Amazon ECS assegna i seguenti tag di sistema a ogni istanza:
+ 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:capacityProviderName` e un *Valore* impostato sul nome del provider di capacità.
+ Un tag con una *Chiave* come `aws:ecs:containerInstanceId` e un *Valore* come ID dell'istanza di container per l'istanza gestita da Amazon ECS.
+ Amazon EC2 aggiunge il tag di sistema `aws:ec2:managed-launch` con il valore `ecs-managed-instances`. Inoltre, Amazon EC2 assegna tag di sistema che indicano il modello di avvio usato per creare l'istanza gestita e la Amazon EC2 Fleet di cui l'istanza gestita fa parte.
## Tag personalizzati
Puoi assegnare tag personalizzati aggiuntivi alle istanze gestite da Amazon ECS assegnando tag al provider di capacità e abilitando la propagazione dei tag usando la proprietà `propagateTags`. I tag sul provider di capacità si propagano alle istanze gestite avviate dal fornitore di capacità
La seguente definizione di provider di capacità mostra come è possibile specificare e propagare i tag dal provider di capacità quando si crea il provider di capacità utilizzando il valore `CAPACITY_PROVIDER` per `propagateTags`.
```
{
"name": "my-cluster-managed-instances-cp",
"cluster": "my-cluster",
"tags": [
{
"key":"tag_key",
"value":"tag_value"
}
],
"managedInstancesProvider": {
"infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
"propagateTags": "CAPACITY_PROVIDER",
"instanceLaunchTemplate": {
"ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
"networkConfiguration": {
"subnets": [
"subnet-abcdef01234567",
"subnet-bcdefa98765432"
],
"securityGroups": [
"sg-0123456789abcdef"
]
}
}
}
}
```
**Nota**
Quando si assegnano nuovi tag a un provider di capacità, i tag appena assegnati non verranno propagati alle istanze esistenti ma verranno propagati a tutte le istanze appena create.
I clienti possono aggiungere tag direttamente alle istanze EC2, ma tali tag non vengono propagati al fornitore di capacità
Puoi anche taggare o rimuovere il tag dal fornitore di capacità utilizzando o [Assegnazione di tag a risorse AWS CLI esistenti](tag-resources-console.md#tag-resources-api-sdk) [Assegnare tag alle risorse esistenti (console Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags)
Per ulteriori informazioni sui provider di capacità delle istanze gestite da Amazon ECS, consulta [Provider di capacità di Istanze gestite da Amazon ECS](managed-instances-capacity-providers-concept.md).
# Aggiunta di tag a un'istanza di container di Amazon EC2 per Amazon ECS
Puoi associare i tag alle istanze di container Amazon EC2 per Amazon ECS utilizzando uno dei seguenti metodi:
+ Metodo 1: durante la creazione dell'istanza di container tramite l'API Amazon EC2, la CLI o la console, specifica i tag passando i dati dell'utente all'istanza con il parametro di configurazione dell'agente del container `ECS_CONTAINER_INSTANCE_TAGS`. Ciò crea i tag associati solo all'istanza di container in Amazon ECS, non possono essere elencati utilizzando l'API Amazon EC2. Per ulteriori informazioni, consulta [Bootstrap di istanze di container Linux Amazon ECS per il trasferimento dei dati](bootstrap_container_instance.md).
**Importante**
Se avvii le istanze del container utilizzando un gruppo Amazon EC2 Auto Scaling, devi utilizzare il parametro di configurazione dell'agente ECS\$1CONTAINER\$1INSTANCE\$1TAGS per aggiungere tag. Ciò è dovuto al modo in cui i tag vengono aggiunti alle istanze Amazon EC2 avviate utilizzando i gruppi Auto Scaling.
Di seguito è riportato un esempio di script di dati utente che associa i tag all'istanza di container:
```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
EOF
```
+ Metodo 2: durante la creazione dell'istanza di container tramite l'API Amazon EC2, la CLI o la console, specifica prima i tag con il parametro `TagSpecification.N`. Quindi, passa i dati utente all'istanza utilizzando il parametro di configurazione dell'agente container `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM`. In questo modo li propaga da Amazon EC2 ad Amazon ECS.
Di seguito è riportato un esempio di script di dati utente che propaga i tag associati a un'istanza Amazon EC2 e registra l'istanza con un cluster denominato `MyCluster`.
```
#!/bin/bash
cat <<'EOF' >> /etc/ecs/ecs.config
ECS_CLUSTER=MyCluster
ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
EOF
```
Per fornire l'accesso che consenta ai tag dell'istanza di container di propagarsi da Amazon EC2 ad Amazon ECS, aggiungi manualmente le autorizzazioni seguenti sotto forma di policy in linea al ruolo IAM dell'istanza di container di Amazon ECS. Per ulteriori informazioni, consulta [Aggiunta e rimozione delle policy IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html).
+ `ec2:DescribeTags`
Di seguito è riportata una policy di esempio utilizzata per aggiungere tali autorizzazioni.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ec2:DescribeTags"
],
"Resource": "*"
}
]
}
```
------
# Aggiunta di tag alle istanze di container esterne per Amazon ECS
Puoi associare i tag alle istanze di container esterne per Amazon ECS utilizzando uno dei seguenti metodi:
+ Metodo 1: prima di eseguire lo script di installazione per registrare l'istanza esterna nel cluster, crea o modifica il file di configurazione dell'agente del container di Amazon ECS all'indirizzo `/etc/ecs/ecs.config` e aggiungi il parametro di configurazione dell'agente del container `ECS_CONTAINER_INSTANCE_TAGS`. Questo consente di creare i tag associati all'istanza esterna.
Di seguito è riportato un esempio di sintassi.
```
ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
```
+ Metodo 2: dopo aver registrato l'istanza esterna nel cluster, puoi utilizzare il Console di gestione AWS per aggiungere tag. Per ulteriori informazioni, consulta [Assegnare tag alle risorse esistenti (console Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags).
# Report di utilizzo di Amazon ECS
AWS fornisce uno strumento di reporting chiamato Cost Explorer che puoi utilizzare per analizzare il costo e l'utilizzo delle tue risorse Amazon ECS.
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.
I dati di misurazione nel report su costi e utilizzo mostrano l'utilizzo in tutti i processi Amazon ECS. I dati di misurazione includono l'utilizzo della CPU come `vCPU-Hours` e l'utilizzo della memoria come `GB-Hours` per ogni attività eseguita. Il modo in cui tali dati vengono presentati dipende dall'opzione di elaborazione dell'attività.
Per le attività che utilizzano Fargate, la colonna `lineItem/Operation` mostrerà `FargateTask` e verrà visualizzato il costo associato a ciascuna attività.
Per le attività che utilizzano EC2, la colonna `lineItem/Operation` mostrerà `ECSTask-EC2` e le attività non avranno un costo diretto associato. I dati di misurazione mostrati nel report, come l'utilizzo della memoria, rappresenta le risorse totali prenotate dal processo nel periodo di fatturazione indicato. Questi valori possono essere utilizzati per determinare il costo del cluster sottostante delle istanze Amazon EC2. I dati relativi ai costi e all'utilizzo delle istanze di Amazon EC2 verranno elencati separatamente nell'ambito del servizio Amazon EC2.
Puoi anche utilizzare i tag gestiti di Amazon ECS per identificare il servizio o il cluster a cui appartengono i singoli processi. Per ulteriori informazioni, consulta [Uso dei tag per la risoluzione dei problemi](ecs-using-tags.md#tag-resources-for-billing).
**Importante**
I dati di misurazione possono essere visualizzati solo per le attività avviate dopo il 16 novembre 2018. I processi avviati prima di questa data non mostrano i dati di misurazione.
Di seguito è illustrato un esempio dei campi in base a cui puoi ordinare i dati di allocazione dei costi utilizzando lo strumento Cost Explorer.
+ Nome cluster
+ Nome del servizio
+ Tag delle risorse
+ Tipo di lancio
+ Regione AWS
+ Tipo di utilizzo
Per ulteriori informazioni sulla creazione di un report sui AWS costi e sull'utilizzo, consulta il report [AWS sui costi e sull'utilizzo](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) nella *Guida per l'AWS Billing utente*.
## Report di costi e utilizzo a livello di attività
AWS Cost Management può fornire dati sull'utilizzo della CPU e della memoria AWS Cost and Usage Report per ogni attività su Amazon ECS, incluse le attività su Fargate e le attività su EC2. Questi dati sono denominati *Dati di ripartizione dei costi*. Puoi utilizzare questi dati per analizzare i costi e l'utilizzo delle applicazioni. Inoltre, puoi suddividere e allocare i costi a singole unità aziendali e team utilizzando tag di allocazione dei costi e categorie di costi. Per ulteriori informazioni sui dati di *allocazione dei costi suddivisi, consulta Comprendere i dati di allocazione dei* [costi suddivisi nella Guida per l'utente](https://docs.aws.amazon.com/cur/latest/userguide/split-cost-allocation-data.html). AWS Cost and Usage Report
Puoi attivare *Dati di ripartizione dei costi* a livello di attività per l'account nella AWS Cost Management Console. Se disponi di un account di gestione (pagante), puoi scegliere di applicare questa configurazione a tutti gli account collegati.
Dopo aver impostato i *dati di allocazione dei costi suddivisi*, ci saranno colonne aggiuntive sotto l'**splitLineItem**intestazione del rapporto. Per ulteriori informazioni, consulta i [dettagli degli elementi di riga suddivisi nella Guida](https://docs.aws.amazon.com/cur/latest/userguide/split-line-item-columns.html) per l' AWS Cost and Usage Report utente
Per le attività su EC2, questi dati suddividono il costo dell'istanza EC2 in base all'utilizzo delle risorse o alle prenotazioni e alle risorse rimanenti sull'istanza.
Di seguito sono indicati i prerequisiti:
+ Imposta il parametro di configurazione dell'agente Amazon ECS `ECS_DISABLE_METRICS` su `false`.
Quando questa impostazione è impostata`false`, l'agente Amazon ECS invia i parametri ad Amazon. CloudWatch Su Linux, questa impostazione è `false` predefinita e le metriche vengono inviate a. CloudWatch In Windows, questa impostazione è `true` predefinita, quindi è necessario modificarla in modo da `false` inviare le metriche CloudWatch per AWS Cost Management utilizzarle. Per ulteriori informazioni sulla configurazione dell'agente di ECS, consulta [Configurazione dell'agente del container Amazon ECS](ecs-agent-config.md).
+ La versione Docker minima per parametri affidabili è v20.10.13 e successive, inclusa nell'AMI 20220607 ottimizzata per Amazon ECS e successive.
Per utilizzare *Dati di ripartizione dei costi*, devi creare un report e selezionare **Dati di ripartizione dei costi**. Per ulteriori informazioni, consulta [Creazione di report sui costi e sull'utilizzo](https://docs.aws.amazon.com/cur/latest/userguide/cur-create.html) nella Guida per l' AWS Cost and Usage Report utente.
AWS Cost Management calcola i *dati di suddivisione dei costi in base* all'utilizzo della CPU e della memoria dell'attività. AWS Cost Management può utilizzare la CPU e la prenotazione della memoria dell'attività anziché l'utilizzo, se l'utilizzo non è disponibile. Se vedi che il CUR sta utilizzando le prenotazioni, verifica che le istanze del contenitore soddisfino i prerequisiti e che le metriche sull'utilizzo delle risorse dell'attività vengano visualizzate in. CloudWatch