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à. # Metadati delle attività disponibili per le attività di Amazon ECS su EC2 L'agente del container di Amazon ECS fornisce un metodo per recuperare vari metadati dei processi e [statistiche Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats). Questo metodo è noto come endpoint dei metadati dei processi. Sono disponibili le seguenti versioni: + Endpoint dei metadati dei processi versione 4: fornisce una varietà di metadati e statistiche Docker ai container. Può anche fornire dati sulla velocità di rete. Disponibile per processi Amazon ECS lanciati su istanze di Amazon EC2 Linux che eseguono almeno la versione `1.39.0` dell'agente del container Amazon ECS. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete `awsvpc`, l'agente del container Amazon ECS deve essere almeno versione `1.54.0`. Per ulteriori informazioni, consulta [Versione 4 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v4.md). + Endpoint dei metadati dei processi versione 3: fornisce una varietà di metadati e statistiche Docker ai container. Disponibile per processi Amazon ECS lanciati su istanze di Amazon EC2 Linux che eseguono almeno la versione `1.21.0` dell'agente del container Amazon ECS. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete `awsvpc`, l'agente del container Amazon ECS deve essere almeno versione `1.54.0`. Per ulteriori informazioni, consulta [Versione 3 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v3.md). + Endpoint dei metadati dei processi versione 2: disponibile per processi Amazon ECS lanciati su istanze di Amazon EC2 Linux che eseguono almeno la versione `1.17.0` dell'agente del container Amazon ECS. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete `awsvpc`, l'agente del container Amazon ECS deve essere almeno versione `1.54.0`. Per ulteriori informazioni, consulta [Versione 2 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v2.md). Se la tua attività Amazon ECS è ospitata su Amazon EC2 o se utilizza `host` la modalità di rete ed è ospitata su Amazon ECS Managed Instances, puoi anche accedere ai metadati dell'host dell'attività utilizzando l'endpoint Instance Metadata Service ([IMDS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html)). Il comando seguente, se eseguito dall'istanza che ospita l'attività, elenca l'ID dell'istanza host. ``` curl http://169.254.169.254/latest/meta-data/instance-id ``` Se la tua attività Amazon ECS è ospitata su Amazon EC2 e in IPv6 una configurazione -only, puoi accedere ai metadati dell'host delle attività utilizzando l'endpoint IMDS. IPv6 Il comando seguente, se eseguito dall'istanza che ospita l'attività, elenca l'ID dell'istanza host su cui si trova. IPv6 ``` curl http://[fd00:ec2::254]/latest/meta-data/instance-id ``` Per accedere all'endpoint IPv6 IMDS, abilita l'endpoint IPv6 IMDS sull'istanza del contenitore e configura anche la modalità endpoint del servizio di metadati utilizzando il provider di credenziali IMDS per l'SDK scelto. `IPv6` Per ulteriori informazioni sull'abilitazione dell'endpoint IPv6 IMDS per l'istanza del contenitore, consulta le [opzioni del servizio di metadati dell'istanza nella](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) Guida per l'utente di *Amazon* EC2. *Per ulteriori informazioni sul provider di credenziali IMDS per SDKs, consulta il provider di credenziali [IMDS nella and Tools Reference Guide](https://docs.aws.amazon.com/sdkref/latest/guide/feature-imds-credentials.html).AWS SDKs * **Nota** L'endpoint IPv6 IMDS non è accessibile quando l'impostazione dell'account è abilitata. `awsvpcTrunking` Per accedere alle credenziali del ruolo IAM dell'istanza di container quando `awsvpcTrunking` è abilitato, puoi invece utilizzare un ruolo IAM dell'attività. Per ulteriori informazioni sui ruoli IAM delle attività, consulta [Ruolo IAM dell'attività Amazon ECS](task-iam-roles.md). Le informazioni che è possibile ottenere dall'endpoint sono suddivise in categorie, ad esempio `instance-id`. Per ulteriori informazioni sulle diverse categorie di metadati delle istanze host che è possibile ottenere utilizzando l'endpoint, consulta [Categorie di metadati dell'istanza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories). # Versione 4 degli endpoint dei metadati delle attività di Amazon ECS L'agente del container Amazon ECS inserisce una variabile di ambiente in ogni container denominata *endpoint dei metadati dei processi* che fornisce vari metadati di processi e [statistiche Docker](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats) al container. I metadati delle attività e le statistiche sulla velocità di rete vengono inviati a CloudWatch Container Insights e possono essere visualizzati in. Console di gestione AWS Per ulteriori informazioni, consulta [Monitora i container di Amazon ECS utilizzando Container Insights con osservabilità migliorata.](cloudwatch-container-insights.md). **Nota** Amazon ECS offre versioni precedenti dell'endpoint dei metadati dei processi. Per evitare la necessità di creare nuove versioni degli endpoint dei metadati delle attività in futuro, ulteriori metadati potrebbero essere aggiunti all'output della versione 4. Non rimuoveremo i metadati esistenti né modificheremo i nomi dei campi dei metadati. La variabile di ambiente viene inserita di default nei container dei processi Amazon ECS lanciati su istanze Linux di Amazon EC2 che eseguono almeno la versione `1.39.0` dell'agente del container Amazon ECS. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete `awsvpc`, l'agente del container Amazon ECS deve essere almeno versione `1.54.0`. Per ulteriori informazioni, consulta [Gestione delle istanze di container Amazon ECS Linux](manage-linux.md). **Nota** Questa caratteristica può essere supportata sulle istanze Amazon EC2 utilizzando versioni precedenti dell'agente di container Amazon ECS aggiornando l'agente alla versione più recente. Per ulteriori informazioni, consulta [Aggiornamento dell'agente del container Amazon ECS](ecs-agent-update.md). Per l'output di esempio dei metadati delle attività, consulta [Esempi della V4 dei metadati delle attività di Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v4-examples.html). ## Percorsi dell'endpoint dei metadati dei processi versione 4 Per i container sono disponibili i seguenti endpoint dei metadati dei processi: `${ECS_CONTAINER_METADATA_URI_V4}` Questo percorso restituisce il file JSON dei metadati per il container. `${ECS_CONTAINER_METADATA_URI_V4}/task` Questo percorso restituisce i metadati per l'attività, incluso un elenco del contenitore IDs e i nomi di tutti i contenitori associati all'attività. Per ulteriori informazioni sulle risposte per questo endpoint, consulta [Risposta JSON relativa alla V4 dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v4-response.md). `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` Questo percorso restituisce i metadati per il processo incluso nell'endpoint `/task` oltre ai tag dell'istanza di processo e container che possono essere recuperati utilizzando l'API `ListTagsForResource`. Eventuali errori ricevuti durante il recupero dei metadati del tag saranno inclusi nel campo `Errors` della risposta. Il campo `Errors` è presente solo nella risposta per i processi ospitati su istanze Linux di Amazon EC2 che eseguono almeno la versione `1.50.0` dell'agente del container. Per istanze Windows di Amazon EC2 che utilizzano la modalità di rete `awsvpc`, l'agente del container Amazon ECS deve essere almeno versione `1.54.0`. Questo endpoint richiede l'autorizzazione `ecs.ListTagsForResource`. Quando usi l'endpoint `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags`, tieni presente che ogni chiamata invia fino a due richieste API a `ecs:ListTagsForResource` (una per i tag delle istanze di container e una per i tag delle attività) e che tutti i container sidecar dell'attività possono effettuare queste chiamate per tuo conto. Le chiamate frequenti agli endpoint possono comportare una limitazione delle API. Valuta la possibilità di implementare strategie di caching o batch per ridurre la frequenza delle chiamate, specialmente nelle applicazioni ad alto traffico, e di eseguire il debugging dei problemi di limitazione delle API utilizzando AWS CloudTrail. Per informazioni sulle limitazioni per l'API `ListTagsForResource`, consulta [Richiedi la limitazione per l'API di Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/request-throttling.html) nella *Documentazione di riferimento delle API di Amazon Elastic Container Service*. Per ulteriori informazioni sul debug delle chiamate API di Amazon ECS utilizzando, consulta AWS CloudTrail. [Registra le chiamate API di Amazon ECS utilizzando AWS CloudTrail](logging-using-cloudtrail.md) `${ECS_CONTAINER_METADATA_URI_V4}/stats` Questo percorso restituisce le statistiche Docker per il container specificato. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta la documentazione dell'API [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)Docker. Per i processi Amazon ECS che utilizzano le modalità di rete `awsvpc` o `bridge` ospitate su istanze Linux Amazon EC2 che eseguono almeno la versione `1.43.0` dell'agente del container, nella risposta saranno presenti anche altre statistiche sulla velocità di rete. Per tutti gli altri processi, la risposta includerà solo le statistiche cumulative di rete. `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` Questo percorso restituisce le statistiche Docker per tutti i container associati al processo. Questo può essere utilizzato dai container sidecar per estrarre i parametri di rete. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta [ContainerStats](https://docs.docker.com/engine/api/v1.30/#operation/ContainerStats)la documentazione dell'API Docker. Per i processi Amazon ECS che utilizzano le modalità di rete `awsvpc` o `bridge` ospitate su istanze Linux Amazon EC2 che eseguono almeno la versione `1.43.0` dell'agente del container, nella risposta saranno presenti anche altre statistiche sulla velocità di rete. Per tutti gli altri processi, la risposta includerà solo le statistiche cumulative di rete. # Risposta JSON relativa alla V4 dei metadati delle attività di Amazon ECS La risposta in formato JSON dell'endpoint dei metadati per l'attività (`${ECS_CONTAINER_METADATA_URI_V4}/task`) restituisce le seguenti informazioni. Oltre ai metadati per ogni container all'interno del processo, sono inclusi anche i metadati associati al processo. `Cluster` L'Amazon Resource Name (ARN) o nome breve del cluster Amazon ECS a cui appartiene il processo. `ServiceName` Il nome del servizio a cui appartiene l'attività. ServiceName verrà visualizzato per le istanze di container Amazon EC2 e Amazon ECS Anywhere se l'attività è associata a un servizio. Questi metadati `ServiceName` sono inclusi solo quando si utilizza la versione dell'agente del container di Amazon ECS versione `1.63.1` o successiva. `VPCID` L'ID VPC dell'istanza di container di Amazon EC2. Questo campo viene visualizzato solo per le istanze Amazon EC2. Questi metadati `VPCID` sono inclusi solo quando si utilizza la versione dell'agente del container di Amazon ECS versione `1.63.1` o successiva. `TaskARN` Il nome della risorsa Amazon (ARN) dell'attività a cui appartiene il container. `Family` La famiglia della definizione di attività Amazon ECS per il processo. `Revision` La revisione della definizione di attività di Amazon ECS per il processo. `DesiredStatus` Lo stato desiderato per il processo da Amazon ECS. `KnownStatus` Lo stato noto per il processo da Amazon ECS. `Limits` I limiti di risorse specificati a livello di attività, come la CPU (espressa in vCPUs) e la memoria. Se non ci sono limiti di risorse definiti, questo parametro viene omesso. `PullStartedAt` Il timestamp dell'inizio della prima estrazione per l'immagine del container. `PullStoppedAt` Il timestamp del termine dell'ultima estrazione per l'immagine del container. `AvailabilityZone` La zona di disponibilità in cui si trova l'attività. I metadati della zona di disponibilità sono disponibili solo per i processi Fargate che utilizzano la versione 1.4 o successiva della piattaforma (Linux) o 1.0.0 (Windows). `LaunchType` Il tipo di avvio utilizzato dall'attività. Quando utilizzi i provider di capacità del cluster, questo indica se il processo utilizza l'infrastruttura Fargate o EC2. Questi metadati `LaunchType` sono inclusi solo quando si utilizza la versione dell'agente del container Linux di Amazon ECS versione `1.45.0` o successiva (Linux) p 1.0.0 o successiva (Windows). `Containers` Un elenco di metadati dei container per ogni container associato all'attività. `DockerId` L'ID Docker per il container. Quando utilizzi Fargate, l'ID è un valore esadecimale a 32 cifre seguito da un numero di 10 cifre. `Name` Il nome del container come specificato nella definizione di attività. `DockerName` Il nome del container fornito a Docker. L'agente del container di Amazon ECS genera un nome univoco per il container al fine di evitare conflitti quando, su una singola istanza, vengono eseguite più copie della stessa definizione di attività. `Image` L'immagine per il container. `ImageID` Il file digest SHA-256 del manifesto delle immagini. Questo è il digest che può essere utilizzato per estrarre l'immagine utilizzando il formato `repository-url/image@sha256:digest`. `Ports` Eventuali porte esposte per il container. Se non ci sono porte esposte, questo parametro viene omesso. `Labels` Eventuali etichette applicate al container. Se non ci sono etichette applicate, questo parametro viene omesso. `DesiredStatus` Lo stato desiderato per il container da Amazon ECS. `KnownStatus` Lo stato noto per il container da Amazon ECS. `ExitCode` Il codice di uscita per il container. Se il container non si è chiuso, questo parametro viene omesso. `Limits` I limiti per le risorse specificati a livello di container, ad esempio CPU (espressa in unità CPU) e memoria. Se non ci sono limiti di risorse definiti, questo parametro viene omesso. `CreatedAt` Il timestamp della creazione del container. Se il container non è ancora stato creato, questo parametro viene omesso. `StartedAt` Il timestamp dell'avvio del container. Se il container non è ancora stato avviato, questo parametro viene omesso. `FinishedAt` Il timestamp dell'arresto del container. Se il container non è ancora stato arrestato, questo parametro viene omesso. `Type` Il tipo di container. I container specificati nella definizione di attività sono di tipo `NORMAL`. Puoi ignorare gli altri tipi di container, utilizzati per il provisioning interno di risorse all'attività da parte dell'agente del container di Amazon ECS. `LogDriver` Il driver di log utilizzato dal container. Questi metadati `LogDriver` sono inclusi solo quando si utilizza la versione dell'agente del container Linux di Amazon ECS versione `1.45.0` o successiva. `LogOptions` Le opzioni del driver di log definite per il container. Questi metadati `LogOptions` sono inclusi solo quando si utilizza la versione dell'agente del container Linux di Amazon ECS versione `1.45.0` o successiva. `ContainerARN` Il nome della risorsa Amazon (ARN) del container. Questi metadati `ContainerARN` sono inclusi solo quando si utilizza la versione dell'agente del container Linux di Amazon ECS versione `1.45.0` o successiva. `Networks` Le informazioni di rete per il container, ad esempio la modalità di rete e l'indirizzo IP. Se non ci sono informazioni di rete definite, questo parametro viene omesso. `RestartCount` Il numero di volte in cui il container è stato riavviato. I metadati `RestartCount` sono inclusi solo se è abilitata una policy di riavvio per il container. Per ulteriori informazioni, consulta [Riavviare singoli container nelle attività Amazon ECS con policy di riavvio dei container](container-restart-policy.md). `ExecutionStoppedAt` Il timestamp del momento in cui le attività `DesiredStatus` sono passate a essere `STOPPED`. Questo si verifica quando un container fondamentale passa allo stato `STOPPED`. # Esempi della V4 dei metadati delle attività Amazon ECS Gli esempi seguenti mostrano gli output di esempio da ognuno degli endpoint dei metadati dei processi. ## Esempio di risposta dei metadati del container Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI_V4}` vengono restituiti solo i metadati relativi al container stesso. Di seguito è riportato un esempio di output di un'attività eseguita come parte di un servizio (MyService). ``` { "DockerId": "ea32192c8553fbff06c9340478a2ff089b2bb5646fb718b4ee206641c9086d66", "Name": "curl", "DockerName": "ecs-curltest-24-curl-cca48e8dcadd97805600", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/8f03e41243824aea923aca126495f665", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "24" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:15:07.620912337Z", "StartedAt": "2020-10-02T00:15:08.062559351Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/8f03e41243824aea923aca126495f665" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/0206b271-b33f-47ab-86c6-a0ba208a70a9", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.100" ], "AttachmentIndex": 0, "MACAddress": "0e:9e:32:c7:48:85", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-100.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ``` ## Esempio di risposta dei metadati dei processi Quando esegui una query sull'endpoint `${ECS_CONTAINER_METADATA_URI_V4}/task`, oltre ai metadati per ciascun container all'interno del processo, vengono restituiti i metadati relativi al processo di cui fa parte il container. Di seguito è riportato un esempio di output. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Processo di esempio con tag con una risposta ai metadati di tag Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` vengono restituiti i metadati relativi al processo, inclusi i tag del processo e dell'istanza di container. Di seguito è riportato un esempio di output. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "TaskTags": { "tag-use": "task-metadata-endpoint-test" }, "ContainerInstanceTags":{ "tag_key":"tag_value" }, "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Processo di esempio con tag con una risposta ai metadati di errore Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI_V4}/taskWithTags` vengono restituiti i metadati relativi al processo, inclusi i tag del processo e dell'istanza di container. Se si verifica un errore nel recupero dei dati di tagging, l'errore viene restituito nella risposta. Di seguito è riportato un output di esempio per quando il ruolo IAM associato all'istanza di container non dispone dell'autorizzazione `ecs:ListTagsForResource` consentita. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "Family": "curltest", "ServiceName": "MyService", "Revision": "26", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "PullStartedAt": "2020-10-02T00:43:06.202617438Z", "PullStoppedAt": "2020-10-02T00:43:06.31288465Z", "AvailabilityZone": "us-west-2d", "VPCID": "vpc-1234567890abcdef0", "Errors": [ { "ErrorField": "ContainerInstanceTags", "ErrorCode": "AccessDeniedException", "ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131", "StatusCode": 400, "RequestId": "cd597ef0-272b-4643-9bd2-1de469870fa6", "ResourceARN": "arn:aws:ecs:us-west-2:111122223333:container-instance/default/2dd1b186f39845a584488d2ef155c131" }, { "ErrorField": "TaskTags", "ErrorCode": "AccessDeniedException", "ErrorMessage": "User: arn:aws:sts::111122223333:assumed-role/ecsInstanceRole/i-0744a608689EXAMPLE is not authorized to perform: ecs:ListTagsForResource on resource: arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3", "StatusCode": 400, "RequestId": "862c5986-6cd2-4aa6-87cc-70be395531e1", "ResourceARN": "arn:aws:ecs:us-west-2:111122223333:task/default/9ef30e4b7aa44d0db562749cff4983f3" } ], "LaunchType": "EC2", "Containers": [ { "DockerId": "598cba581fe3f939459eaba1e071d5c93bb2c49b7d1ba7db6bb19deeb70d8e38", "Name": "~internal~ecs~pause", "DockerName": "ecs-curltest-26-internalecspause-e292d586b6f9dade4a00", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2020-10-02T00:43:05.602352471Z", "StartedAt": "2020-10-02T00:43:06.076707576Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] }, { "DockerId": "ee08638adaaf009d78c248913f629e38299471d45fe7dc944d1039077e3424ca", "Name": "curl", "DockerName": "ecs-curltest-26-curl-a0e7dba5aca6d8cb2e00", "Image": "111122223333.dkr.ecr.us-west-2.amazonaws.com/curltest:latest", "ImageID": "sha256:d691691e9652791a60114e67b365688d20d19940dde7c4736ea30e660d8d3553", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-west-2:111122223333:task/default/158d1c8083dd49d6b527399fd6414f5c", "com.amazonaws.ecs.task-definition-family": "curltest", "com.amazonaws.ecs.task-definition-version": "26" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 10, "Memory": 128 }, "CreatedAt": "2020-10-02T00:43:06.326590752Z", "StartedAt": "2020-10-02T00:43:06.767535449Z", "Type": "NORMAL", "LogDriver": "awslogs", "LogOptions": { "awslogs-create-group": "true", "awslogs-group": "/ecs/metadata", "awslogs-region": "us-west-2", "awslogs-stream": "ecs/curl/158d1c8083dd49d6b527399fd6414f5c" }, "ContainerARN": "arn:aws:ecs:us-west-2:111122223333:container/abb51bdd-11b4-467f-8f6c-adcfe1fe059d", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.61" ], "AttachmentIndex": 0, "MACAddress": "0e:10:e2:01:bd:91", "IPv4SubnetCIDRBlock": "10.0.2.0/24", "PrivateDNSName": "ip-10-0-2-61.us-west-2.compute.internal", "SubnetGatewayIpv4Address": "10.0.2.1/24" } ] } ] } ``` ## Esempio di risposta delle statistiche del container Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI_V4}/stats` vengono restituiti i parametri di rete per il container. Per i processi Amazon ECS che utilizzano le modalità di rete `awsvpc` o `bridge` ospitate su istanze Linux Amazon EC2 che eseguono almeno la versione `1.43.0` dell'agente del container, nella risposta saranno presenti anche altre statistiche sulla velocità di rete. Per tutti gli altri processi, la risposta includerà solo le statistiche cumulative di rete. Di seguito è riportato un esempio di output di un processo Amazon ECS su Amazon EC2 che utilizza la modalità di rete `bridge`. ``` { "read": "2020-10-02T00:51:13.410254284Z", "preread": "2020-10-02T00:51:12.406202398Z", "pids_stats": { "current": 3 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 360968065, "percpu_usage": [ 182359190, 178608875 ], "usage_in_kernelmode": 40000000, "usage_in_usermode": 290000000 }, "system_cpu_usage": 13939680000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 360968065, "percpu_usage": [ 182359190, 178608875 ], "usage_in_kernelmode": 40000000, "usage_in_usermode": 290000000 }, "system_cpu_usage": 13937670000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 1806336, "max_usage": 6299648, "stats": { "active_anon": 606208, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 134217728, "hierarchical_memsw_limit": 268435456, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 4185, "pgmajfault": 0, "pgpgin": 2926, "pgpgout": 2778, "rss": 606208, "rss_huge": 0, "total_active_anon": 606208, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 4185, "total_pgmajfault": 0, "total_pgpgin": 2926, "total_pgpgout": 2778, "total_rss": 606208, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 134217728 }, "name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01", "id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } } ``` ## Esempio di risposta delle statistiche dei processi Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI_V4}/task/stats` vengono restituiti i parametri di rete relativi all'attività di cui fa parte il container. Di seguito è riportato un esempio di output. ``` { "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854": { "read": "2020-10-02T00:51:32.51467703Z", "preread": "2020-10-02T00:51:31.50860463Z", "pids_stats": { "current": 1 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 177232665, "percpu_usage": [ 13376224, 163856441 ], "usage_in_kernelmode": 0, "usage_in_usermode": 160000000 }, "system_cpu_usage": 13977820000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 177232665, "percpu_usage": [ 13376224, 163856441 ], "usage_in_kernelmode": 0, "usage_in_usermode": 160000000 }, "system_cpu_usage": 13975800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 532480, "max_usage": 6279168, "stats": { "active_anon": 40960, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 9223372036854771712, "hierarchical_memsw_limit": 9223372036854771712, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 2033, "pgmajfault": 0, "pgpgin": 1734, "pgpgout": 1724, "rss": 40960, "rss_huge": 0, "total_active_anon": 40960, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 2033, "total_pgmajfault": 0, "total_pgpgin": 1734, "total_pgpgout": 1724, "total_rss": 40960, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 4073377792 }, "name": "/ecs-curltest-26-internalecspause-a6bcc3dbadfacfe85300", "id": "01999f2e5c6cf4df3873f28950e6278813408f281c54778efec860d0caad4854", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } }, "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af": { "read": "2020-10-02T00:51:32.512771349Z", "preread": "2020-10-02T00:51:31.510597736Z", "pids_stats": { "current": 3 }, "blkio_stats": { "io_service_bytes_recursive": [ ], "io_serviced_recursive": [ ], "io_queue_recursive": [ ], "io_service_time_recursive": [ ], "io_wait_time_recursive": [ ], "io_merged_recursive": [ ], "io_time_recursive": [ ], "sectors_recursive": [ ] }, "num_procs": 0, "storage_stats": { }, "cpu_stats": { "cpu_usage": { "total_usage": 379075681, "percpu_usage": [ 191355275, 187720406 ], "usage_in_kernelmode": 60000000, "usage_in_usermode": 310000000 }, "system_cpu_usage": 13977800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "precpu_stats": { "cpu_usage": { "total_usage": 378825197, "percpu_usage": [ 191104791, 187720406 ], "usage_in_kernelmode": 60000000, "usage_in_usermode": 310000000 }, "system_cpu_usage": 13975800000000, "online_cpus": 2, "throttling_data": { "periods": 0, "throttled_periods": 0, "throttled_time": 0 } }, "memory_stats": { "usage": 1814528, "max_usage": 6299648, "stats": { "active_anon": 606208, "active_file": 0, "cache": 0, "dirty": 0, "hierarchical_memory_limit": 134217728, "hierarchical_memsw_limit": 268435456, "inactive_anon": 0, "inactive_file": 0, "mapped_file": 0, "pgfault": 5377, "pgmajfault": 0, "pgpgin": 3613, "pgpgout": 3465, "rss": 606208, "rss_huge": 0, "total_active_anon": 606208, "total_active_file": 0, "total_cache": 0, "total_dirty": 0, "total_inactive_anon": 0, "total_inactive_file": 0, "total_mapped_file": 0, "total_pgfault": 5377, "total_pgmajfault": 0, "total_pgpgin": 3613, "total_pgpgout": 3465, "total_rss": 606208, "total_rss_huge": 0, "total_unevictable": 0, "total_writeback": 0, "unevictable": 0, "writeback": 0 }, "limit": 134217728 }, "name": "/ecs-curltest-26-curl-c2e5f6e0cf91b0bead01", "id": "5fc21e5b015f899d22618f8aede80b6d70d71b2a75465ea49d9462c8f3d2d3af", "networks": { "eth0": { "rx_bytes": 84, "rx_packets": 2, "rx_errors": 0, "rx_dropped": 0, "tx_bytes": 84, "tx_packets": 2, "tx_errors": 0, "tx_dropped": 0 } }, "network_rate_stats": { "rx_bytes_per_sec": 0, "tx_bytes_per_sec": 0 } } } ``` # Versione 3 degli endpoint dei metadati delle attività di Amazon ECS **Importante** L'endpoint dei metadati delle attività versione 3 non viene più gestito attivamente. Ti consigliamo di aggiornare l'endpoint dei metadati delle attività versione 4 per ottenere le informazioni più recenti sull'endpoint dei metadati. Per ulteriori informazioni, consulta [Versione 4 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v4.md). Se utilizzi attività di Amazon ECS ospitate su AWS Fargate, consulta l'[endpoint di metadati delle attività Amazon ECS versione 3 per le attività](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-metadata-endpoint-v3-fargate.html) su Fargate. A partire dalla versione 1.21.0 dell'agente del container di Amazon ECS, l'agente inserisce una variabile di ambiente denominata `ECS_CONTAINER_METADATA_URI` in ogni container in un processo. Quando esegui una query sull'endpoint dei metadati delle attività versione 3, per le attività vengono resi disponibili diversi metadati delle attività e [statistiche Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats). Per le attività che utilizzano la modalità di rete `bridge`, sono disponibili parametri di rete durante l'esecuzione di query sugli endpoint `/stats`. L'endpoint dei metadati dei processi versione 3 è abilitato di default per i processi che utilizzano Fargate sulla versione della piattaforma v1.3.0 o successiva e per processi che utilizzano EC2 e che vengono avviati sull'infrastruttura Linux di Amazon EC2 che esegue almeno la versione 1.21.0 dell'agente del container Amazon ECS o sull'infrastruttura Windows di Amazon EC2. che esegue almeno la versione `1.54.0` dell'agente del container Amazon ECS e utilizzano la modalità di rete `awsvpc`. Per ulteriori informazioni, consulta [Gestione delle istanze di container Amazon ECS Linux](manage-linux.md). Questa caratteristica può essere supportata sulle istanze di container precedenti aggiornando l'agente alla versione più recente. Per ulteriori informazioni, consulta [Aggiornamento dell'agente del container Amazon ECS](ecs-agent-update.md). **Importante** Per attività che utilizzano Fargate e versioni della piattaforma precedenti alla v1.3.0, è supportato l'endpoint dei metadati dei processi versione 2. Per ulteriori informazioni, consulta [Versione 2 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v2.md). ## Percorsi dell'endpoint dei metadati delle attività versione 3 Per i container sono disponibili i seguenti endpoint dei metadati delle attività: `${ECS_CONTAINER_METADATA_URI}` Questo percorso restituisce il file JSON dei metadati per il container. `${ECS_CONTAINER_METADATA_URI}/task` Questo percorso restituisce i metadati JSON per l'attività, incluso un elenco del contenitore IDs e i nomi di tutti i contenitori associati all'attività. Per ulteriori informazioni sulle risposte per questo endpoint, consulta [Risposta JSON relativa alla V3 dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v3-response.md). `${ECS_CONTAINER_METADATA_URI}/taskWithTags` Questo percorso restituisce i metadati per il processo incluso nell'endpoint `/task` oltre ai tag dell'istanza di processo e container che possono essere recuperati utilizzando l'API `ListTagsForResource`. `${ECS_CONTAINER_METADATA_URI}/stats` Questo percorso restituisce un file JSON con le statistiche Docker per il container Docker specificato. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)la documentazione dell'API Docker. `${ECS_CONTAINER_METADATA_URI}/task/stats` Questo percorso restituisce un file JSON delle statistiche Docker per tutti i container associati all'attività. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)la documentazione dell'API Docker. # Risposta JSON relativa alla V3 dei metadati delle attività di Amazon ECS La risposta in formato JSON dell'endpoint dei metadati per l'attività (`${ECS_CONTAINER_METADATA_URI}/task`) restituisce le seguenti informazioni. `Cluster` L'Amazon Resource Name (ARN) o nome breve del cluster Amazon ECS a cui appartiene il processo. `TaskARN` Il nome della risorsa Amazon (ARN) dell'attività a cui appartiene il container. `Family` La famiglia della definizione di attività Amazon ECS per il processo. `Revision` La revisione della definizione di attività di Amazon ECS per il processo. `DesiredStatus` Lo stato desiderato per il processo da Amazon ECS. `KnownStatus` Lo stato noto per il processo da Amazon ECS. `Limits` I limiti di risorse specificati a livello di attività, come la CPU (espressa in vCPUs) e la memoria. Se non ci sono limiti di risorse definiti, questo parametro viene omesso. `PullStartedAt` Il timestamp dell'inizio della prima estrazione per l'immagine del container. `PullStoppedAt` Il timestamp del termine dell'ultima estrazione per l'immagine del container. `AvailabilityZone` La zona di disponibilità in cui si trova l'attività. I metadati della zona di disponibilità sono disponibili solo per i processi Fargate che utilizzano la versione 1.4 o successiva della piattaforma (Linux) o 1.0.0 o successiva (Windows). `Containers` Un elenco di metadati dei container per ogni container associato all'attività. `DockerId` L'ID Docker per il container. `Name` Il nome del container come specificato nella definizione di attività. `DockerName` Il nome del container fornito a Docker. L'agente del container di Amazon ECS genera un nome univoco per il container al fine di evitare conflitti quando, su una singola istanza, vengono eseguite più copie della stessa definizione di attività. `Image` L'immagine per il container. `ImageID` Il file digest SHA-256 del manifesto delle immagini. Questo è il digest che può essere utilizzato per estrarre l'immagine utilizzando il formato `repository-url/image@sha256:digest`. `Ports` Eventuali porte esposte per il container. Se non ci sono porte esposte, questo parametro viene omesso. `Labels` Eventuali etichette applicate al container. Se non ci sono etichette applicate, questo parametro viene omesso. `DesiredStatus` Lo stato desiderato per il container da Amazon ECS. `KnownStatus` Lo stato noto per il container da Amazon ECS. `ExitCode` Il codice di uscita per il container. Se il container non si è chiuso, questo parametro viene omesso. `Limits` I limiti per le risorse specificati a livello di container, ad esempio CPU (espressa in unità CPU) e memoria. Se non ci sono limiti di risorse definiti, questo parametro viene omesso. `CreatedAt` Il timestamp della creazione del container. Se il container non è ancora stato creato, questo parametro viene omesso. `StartedAt` Il timestamp dell'avvio del container. Se il container non è ancora stato avviato, questo parametro viene omesso. `FinishedAt` Il timestamp dell'arresto del container. Se il container non è ancora stato arrestato, questo parametro viene omesso. `Type` Il tipo di container. I container specificati nella definizione di attività sono di tipo `NORMAL`. Puoi ignorare gli altri tipi di container, utilizzati per il provisioning interno di risorse all'attività da parte dell'agente del container di Amazon ECS. `Networks` Le informazioni di rete per il container, ad esempio la modalità di rete e l'indirizzo IP. Se non ci sono informazioni di rete definite, questo parametro viene omesso. `ClockDrift` Le informazioni sulla differenza tra l'ora di riferimento e l'ora del sistema. Questo vale per il sistema operativo Linux. Questa funzionalità utilizza il servizio di sincronizzazione oraria di Amazon per misurare la precisione dell'orologio e fornire il suo limite di errore per i container. Per ulteriori informazioni, consulta [Impostazione dell'orario di un'istanza Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) nella *Guida per l'utente di Amazon EC2 per le istanze Linux*. `ReferenceTime` La base della precisione dell'orologio. Amazon ECS utilizza lo standard globale Coordinated Universal Time (UTC) tramite NTP, ad esempio `2021-09-07T16:57:44Z`. `ClockErrorBound` La misura dell'errore di clock, definita come offset rispetto a UTC. Questo errore è la differenza in millisecondi tra l'ora di riferimento e l'ora del sistema. `ClockSynchronizationStatus` Indica se il tentativo di sincronizzazione più recente tra l'ora del sistema e l'ora di riferimento ha avuto esito positivo. I valori validi sono `SYNCHRONIZED` e ` NOT_SYNCHRONIZED`. `ExecutionStoppedAt` Il timestamp del momento in cui le attività `DesiredStatus` sono passate a essere `STOPPED`. Questo si verifica quando un container fondamentale passa allo stato `STOPPED`. # Esempi della V3 dei metadati delle attività Amazon ECS Gli esempi seguenti mostrano gli output di esempio degli endpoint dei metadati delle attività. ## Esempio di risposta dei metadati del container Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI}` vengono restituiti solo i metadati relativi al container stesso. Di seguito è riportato un esempio di output. ``` { "DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946", "Name": "nginx-curl", "DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901", "Image": "nrdlngr/nginx-curl", "ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "nginx-curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 512, "Memory": 512 }, "CreatedAt": "2018-02-01T20:55:10.554941919Z", "StartedAt": "2018-02-01T20:55:11.064236631Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] } ``` ## Esempio di risposta dei metadati del processo Quando si esegue una query sull'endpoint `${ECS_CONTAINER_METADATA_URI}/task` vengono restituiti i metadati relativi all'attività di cui fa parte il container. Di seguito è riportato un esempio di output. La seguente risposta JSON è relativa a un'attività con un unico container. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "Family": "nginx", "Revision": "5", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Containers": [ { "DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c", "Name": "~internal~ecs~pause", "DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2018-02-01T20:55:08.366329616Z", "StartedAt": "2018-02-01T20:55:09.058354915Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] }, { "DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946", "Name": "nginx-curl", "DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901", "Image": "nrdlngr/nginx-curl", "ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "nginx-curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 512, "Memory": 512 }, "CreatedAt": "2018-02-01T20:55:10.554941919Z", "StartedAt": "2018-02-01T20:55:11.064236631Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] } ], "PullStartedAt": "2018-02-01T20:55:09.372495529Z", "PullStoppedAt": "2018-02-01T20:55:10.552018345Z", "AvailabilityZone": "us-east-2b" } ``` # Versione 2 degli endpoint dei metadati delle attività di Amazon ECS **Importante** L'endpoint dei metadati delle attività versione 2 non viene più gestito attivamente. Ti consigliamo di aggiornare l'endpoint dei metadati delle attività versione 4 per ottenere le informazioni più recenti sull'endpoint dei metadati. Per ulteriori informazioni, consulta [Versione 4 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v4.md). A partire dalla versione 1.17.0 dell'agente del container Amazon ECS, sono disponibili diversi metadati dei processi e [statistiche Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) per i processi che utilizzano la modalità di rete `awsvpc` in un endpoint HTTP fornito dall'agente del container Amazon ECS. Tutti i contenitori appartenenti alle attività avviate con la modalità di `awsvpc` rete ricevono un IPv4 indirizzo locale all'interno di un intervallo di indirizzi locale del collegamento predefinito. Quando un container invia una query all'endpoint dei metadati, l'agente del container di Amazon ECS è in grado di determinare a quale processo appartiene il container in base al suo indirizzo IP univoco, per restituire quindi metadati e statistiche per tale processo. ## Abilitazione dei metadati dei processi **Importante** L'endpoint dei metadati delle attività versione 2 non viene più gestito attivamente. Ti consigliamo di aggiornare l'endpoint dei metadati delle attività versione 4 per ottenere le informazioni più recenti sull'endpoint dei metadati. Per ulteriori informazioni, consulta [Versione 4 degli endpoint dei metadati delle attività di Amazon ECS](task-metadata-endpoint-v4.md). A partire dalla versione 1.17.0 dell'agente del container Amazon ECS, sono disponibili diversi metadati dei processi e [statistiche Docker](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats) per i processi che utilizzano la modalità di rete `awsvpc` in un endpoint HTTP fornito dall'agente del container Amazon ECS. Tutti i contenitori appartenenti alle attività avviate con la modalità di `awsvpc` rete ricevono un indirizzo locale all'interno di un intervallo di IPv4 indirizzi locale del collegamento predefinito. Quando un container invia una query all'endpoint dei metadati, l'agente del container di Amazon ECS è in grado di determinare a quale processo appartiene il container in base al suo indirizzo IP univoco, per restituire quindi metadati e statistiche per tale processo. ### Abilitazione dei metadati dei processi La caratteristica dei metadati delle attività versione 2 è abilitata di default per: + Processi con Fargate che utilizzano la versione della piattaforma 1.1.0 o successive. Per ulteriori informazioni, consulta [Versioni della piattaforma Fargate per Amazon ECS](platform-fargate.md). + Processi che utilizzano EC2 che utilizzano anche la modalità di rete `awsvpc` e che vengono avviati su un'infrastruttura Linux di Amazon EC2 con almeno la versione 1.17.0 dell'agente del container Amazon ECS o su un'infrastruttura Windows di Amazon EC2 con almeno la versione `1.54.0` dell'agente del container Amazon ECS. Per ulteriori informazioni, consulta [Gestione delle istanze di container Amazon ECS Linux](manage-linux.md). Questa caratteristica può essere supportata sulle istanze di container precedenti aggiornando l'agente alla versione più recente. Per ulteriori informazioni, consulta [Aggiornamento dell'agente del container Amazon ECS](ecs-agent-update.md). ### Percorsi per gli endpoint dei metadati dei processi Per i container sono disponibili i seguenti endpoint API: `169.254.170.2/v2/metadata` Questo endpoint restituisce i metadati JSON per l'attività, incluso un elenco del contenitore IDs e i nomi di tutti i contenitori associati all'attività. Per ulteriori informazioni sulle risposte per questo endpoint, consulta [Risposta JSON per i metadati dei processi](#task-metadata-endpoint-v2-response). `169.254.170.2/v2/metadata/` Questo endpoint restituisce un file JSON con i metadati per l'ID container Docker specificato. `169.254.170.2/v2/metadata/taskWithTags` Questo percorso restituisce i metadati per il processo incluso nell'endpoint `/task` oltre ai tag dell'istanza di processo e container che possono essere recuperati utilizzando l'API `ListTagsForResource`. `169.254.170.2/v2/stats` Questo endpoint restituisce un file JSON delle statistiche Docker per tutti i container associati all'attività. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta la documentazione dell'[ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)API Docker. `169.254.170.2/v2/stats/` Questo endpoint restituisce un file JSON con le statistiche Docker per l'ID container Docker specificato. Per ulteriori informazioni su ciascuna delle statistiche restituite, consulta [ContainerStats](https://docs.docker.com/reference/api/engine/version/v1.30/#tag/Container/operation/ContainerStats)la documentazione dell'API Docker. ### Risposta JSON per i metadati dei processi La risposta in formato JSON dell'endpoint dei metadati per l'attività (`169.254.170.2/v2/metadata`) restituisce le seguenti informazioni. `Cluster` L'Amazon Resource Name (ARN) o nome breve del cluster Amazon ECS a cui appartiene il processo. `TaskARN` Il nome della risorsa Amazon (ARN) dell'attività a cui appartiene il container. `Family` La famiglia della definizione di attività Amazon ECS per il processo. `Revision` La revisione della definizione di attività di Amazon ECS per il processo. `DesiredStatus` Lo stato desiderato per il processo da Amazon ECS. `KnownStatus` Lo stato noto per il processo da Amazon ECS. `Limits` I limiti di risorse specificati a livello di attività, come la CPU (espressa in vCPUs) e la memoria. Se non ci sono limiti di risorse definiti, questo parametro viene omesso. `PullStartedAt` Il timestamp dell'inizio della prima estrazione per l'immagine del container. `PullStoppedAt` Il timestamp del termine dell'ultima estrazione per l'immagine del container. `AvailabilityZone` La zona di disponibilità in cui si trova l'attività. I metadati della zona di disponibilità sono disponibili solo per i processi Fargate che utilizzano la versione 1.4 o successiva della piattaforma (Linux) o 1.0.0 o successiva (Windows). `Containers` Un elenco di metadati dei container per ogni container associato all'attività. `DockerId` L'ID Docker per il container. `Name` Il nome del container come specificato nella definizione di attività. `DockerName` Il nome del container fornito a Docker. L'agente del container di Amazon ECS genera un nome univoco per il container al fine di evitare conflitti quando, su una singola istanza, vengono eseguite più copie della stessa definizione di attività. `Image` L'immagine per il container. `ImageID` Il file digest SHA-256 del manifesto delle immagini. Questo è il digest che può essere utilizzato per estrarre l'immagine utilizzando il formato `repository-url/image@sha256:digest`. `Ports` Eventuali porte esposte per il container. Se non ci sono porte esposte, questo parametro viene omesso. `Labels` Eventuali etichette applicate al container. Se non ci sono etichette applicate, questo parametro viene omesso. `DesiredStatus` Lo stato desiderato per il container da Amazon ECS. `KnownStatus` Lo stato noto per il container da Amazon ECS. `ExitCode` Il codice di uscita per il container. Se il container non si è chiuso, questo parametro viene omesso. `Limits` I limiti per le risorse specificati a livello di container, ad esempio CPU (espressa in unità CPU) e memoria. Se non ci sono limiti di risorse definiti, questo parametro viene omesso. `CreatedAt` Il timestamp della creazione del container. Se il container non è ancora stato creato, questo parametro viene omesso. `StartedAt` Il timestamp dell'avvio del container. Se il container non è ancora stato avviato, questo parametro viene omesso. `FinishedAt` Il timestamp dell'arresto del container. Se il container non è ancora stato arrestato, questo parametro viene omesso. `Type` Il tipo di container. I container specificati nella definizione di attività sono di tipo `NORMAL`. Puoi ignorare gli altri tipi di container, utilizzati per il provisioning interno di risorse all'attività da parte dell'agente del container di Amazon ECS. `Networks` Le informazioni di rete per il container, ad esempio la modalità di rete e l'indirizzo IP. Se non ci sono informazioni di rete definite, questo parametro viene omesso. `ClockDrift` Le informazioni sulla differenza tra l'ora di riferimento e l'ora del sistema. Questo vale per il sistema operativo Linux. Questa funzionalità utilizza il servizio di sincronizzazione oraria di Amazon per misurare la precisione dell'orologio e fornire il suo limite di errore per i container. Per ulteriori informazioni, consulta [Impostazione dell'orario di un'istanza Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) nella *Guida per l'utente di Amazon EC2 per le istanze Linux*. `ReferenceTime` La base della precisione dell'orologio. Amazon ECS utilizza lo standard globale Coordinated Universal Time (UTC) tramite NTP, ad esempio `2021-09-07T16:57:44Z`. `ClockErrorBound` La misura dell'errore di clock, definita come offset rispetto a UTC. Questo errore è la differenza in millisecondi tra l'ora di riferimento e l'ora del sistema. `ClockSynchronizationStatus` Indica se il tentativo di sincronizzazione più recente tra l'ora del sistema e l'ora di riferimento ha avuto esito positivo. I valori validi sono `SYNCHRONIZED` e ` NOT_SYNCHRONIZED`. `ExecutionStoppedAt` Il timestamp del momento in cui le attività `DesiredStatus` sono passate a essere `STOPPED`. Questo si verifica quando un container fondamentale passa allo stato `STOPPED`. ### Esempio di risposta dei metadati del processo La seguente risposta JSON è relativa a un'attività con un unico container. ``` { "Cluster": "default", "TaskARN": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "Family": "nginx", "Revision": "5", "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Containers": [ { "DockerId": "731a0d6a3b4210e2448339bc7015aaa79bfe4fa256384f4102db86ef94cbbc4c", "Name": "~internal~ecs~pause", "DockerName": "ecs-nginx-5-internalecspause-acc699c0cbf2d6d11700", "Image": "amazon/amazon-ecs-pause:0.1.0", "ImageID": "", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "~internal~ecs~pause", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RESOURCES_PROVISIONED", "KnownStatus": "RESOURCES_PROVISIONED", "Limits": { "CPU": 0, "Memory": 0 }, "CreatedAt": "2018-02-01T20:55:08.366329616Z", "StartedAt": "2018-02-01T20:55:09.058354915Z", "Type": "CNI_PAUSE", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] }, { "DockerId": "43481a6ce4842eec8fe72fc28500c6b52edcc0917f105b83379f88cac1ff3946", "Name": "nginx-curl", "DockerName": "ecs-nginx-5-nginx-curl-ccccb9f49db0dfe0d901", "Image": "nrdlngr/nginx-curl", "ImageID": "sha256:2e00ae64383cfc865ba0a2ba37f61b50a120d2d9378559dcd458dc0de47bc165", "Labels": { "com.amazonaws.ecs.cluster": "default", "com.amazonaws.ecs.container-name": "nginx-curl", "com.amazonaws.ecs.task-arn": "arn:aws:ecs:us-east-2:012345678910:task/9781c248-0edd-4cdb-9a93-f63cb662a5d3", "com.amazonaws.ecs.task-definition-family": "nginx", "com.amazonaws.ecs.task-definition-version": "5" }, "DesiredStatus": "RUNNING", "KnownStatus": "RUNNING", "Limits": { "CPU": 512, "Memory": 512 }, "CreatedAt": "2018-02-01T20:55:10.554941919Z", "StartedAt": "2018-02-01T20:55:11.064236631Z", "Type": "NORMAL", "Networks": [ { "NetworkMode": "awsvpc", "IPv4Addresses": [ "10.0.2.106" ] } ] } ], "PullStartedAt": "2018-02-01T20:55:09.372495529Z", "PullStoppedAt": "2018-02-01T20:55:10.552018345Z", "AvailabilityZone": "us-east-2b" } ```