Endpoint di metadati delle attività Amazon ECS versione 3

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 Endpoint di metadati delle attività Amazon ECS versione 4.

Se utilizzi attività di Amazon ECS ospitate su AWS Fargate, consulta l'endpoint di metadati delle attività Amazon ECS versione 3 per le attività 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. Per le attività che utilizzano la modalità di rete bridge, sono disponibili parametri di rete durante l'esecuzione di query sugli endpoint /stats.

La funzionalità task metadata endpoint versione 3 è abilitata per impostazione predefinita per le attività che utilizzano il tipo di avvio Fargate nella versione della piattaforma v1.3.0 o successiva e per le attività che utilizzano il tipo di EC2 avvio e vengono avviate sull'infrastruttura Amazon EC2 Linux che esegue almeno la versione 1.21.0 dell'agente container Amazon ECS o sull' EC2 infrastruttura Amazon Windows che esegue almeno la versione dell'agente contenitore Amazon ECS e utilizza 1.54.0 la modalità di rete. awsvpc Per ulteriori informazioni, consulta Gestione delle istanze di container Amazon ECS Linux.

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.

Importante

Per attività che utilizzano il tipo di avvio Fargate e versioni della piattaforma precedenti alla v1.3.0, è supportato l'endpoint dei metadati dei processi versione 2. Per ulteriori informazioni, consulta Endpoint di metadati delle attività Amazon ECS versione 2.

Percorsi della versione 3 dell'endpoint Task Metadata

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 v3 dei metadati delle attività di Amazon ECS.

${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 ContainerStatsla 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 ContainerStatsla documentazione dell'API Docker.