

# Resposta JSON para metadados de tarefas v4 no Amazon ECS para tarefas no Fargate
<a name="task-metadata-endpoint-v4-fargate-response"></a>

Os seguintes metadados são retornados na resposta em formato JSON (`${ECS_CONTAINER_METADATA_URI_V4}/task`) do endpoint de metadados da tarefa.

`Cluster`  
O nome do recurso da Amazon (ARN) ou nome curto do cluster do Amazon ECS ao qual a tarefa pertence.

`ServiceName`  
O nome do serviço ao qual a tarefa pertence. ServiceName será exibido para tarefas do Fargate associadas a um serviço.

`VPCID`  
O ID da VPC da instância de contêiner do Amazon EC2. Esse campo é exibido somente para instâncias do Amazon EC2.  
Os metadados `VPCID` são incluídos somente quando é usada a versão `1.63.1` ou posterior do agente de contêiner do Amazon ECS.

`TaskARN`  
O nome do recurso da Amazon (ARN) da tarefa à qual o contêiner pertence.

`Family`  
A família da definição de tarefa do Amazon ECS para a tarefa.

`Revision`  
A revisão da definição de tarefa do Amazon ECS para a tarefa.

`DesiredStatus`  
O status desejado para a tarefa do Amazon ECS.

`KnownStatus`  
O status conhecido para a tarefa do Amazon ECS.

`Limits`  
Os limites de recursos especificados nos níveis da tarefa, como CPU (expresso em vCPUs) e memória. Esse parâmetro será omitido se não houver nenhum limite de recurso definido.

`PullStartedAt`  
O timestamp de quando começou a primeira extração de imagem do contêiner.

`PullStoppedAt`  
O timestamp de quando a última extração de imagem do contêiner terminou.

`AvailabilityZone`  
A zona de disponibilidade em que a tarefa está.  
Os metadados da zona de disponibilidade estão disponíveis apenas para tarefas do Fargate que usam a versão 1.4 ou posterior (Linux) ou 1.0.0 (Windows) da plataforma.

`LaunchType`  
O tipo de inicialização que a tarefa está usando. Ao usar provedores de capacidade de cluster, isso indica se a tarefa está usando a infraestrutura do Fargate ou do EC2.  
Esses metadados `LaunchType` estão incluídos somente quando é usada a versão `1.45.0` ou posterior (Linux) ou 1.0.0 ou posterior (Windows) do agente de contêiner do Linux do Amazon ECS.

`EphemeralStorageMetrics`  
O tamanho reservado e o uso atual do armazenamento temporário dessa tarefa.   
O Fargate reserva espaço no disco. Esse espaço é usado apenas pelo Fargate. Você não é cobrado por isso. Ele não é mostrado nessas métricas. Porém, você pode ver esse armazenamento adicional em outras ferramentas, como o `df`.  
`Utilized`  
O uso atual de armazenamento temporário (em MiB) dessa tarefa.  
`Reserved`  
O armazenamento temporário reservado (em MiB) dessa tarefa. O tamanho do armazenamento temporário não pode ser alterado em uma tarefa em execução. É possível especificar o objeto `ephermalStorage` na sua definição de tarefa para alterar a quantidade de armazenamento temporário. O `ephermalStorage` é especificado em GiB, não em MiB. O `ephermalStorage` e as `EphemeralStorageMetrics` só estão disponíveis na versão 1.4.0 ou posterior da plataforma Linux do Fargate.

`Containers`  
Uma lista de metadados de contêiner para cada contêiner associado com a tarefa.    
`DockerId`  
O ID do Docker do contêiner.  
Quando você usa Fargate, o id é um hexadecimal de 32 dígitos seguido por um número de 10 dígitos.  
`Name`  
O nome do contêiner, conforme especificado na definição da tarefa.  
`DockerName`  
O nome do contêiner fornecido para o Docker. O agente de contêiner do Amazon ECS gera um nome exclusivo para o contêiner para evitar colisões de nomes quando várias cópias da mesma definição de tarefa são executadas em uma única instância.  
`Image`  
A imagem para o contêiner.  
`ImageID`  
O resumo SHA-256 do manifesto da imagem. Esse é o resumo que pode ser usado para extrair a imagem usando o formato `repository-url/image@sha256:digest`.  
`Ports`  
Todas as portas expostas para o contêiner. Esse parâmetro será omitido se não houver portas expostas.  
`Labels`  
Todos os rótulos aplicados ao contêiner. Esse parâmetro será omitido se não houver rótulos aplicados.  
`DesiredStatus`  
O status desejado para o contêiner do Amazon ECS.  
`KnownStatus`  
O status conhecido para o contêiner do Amazon ECS.  
`ExitCode`  
O código de saída para o contêiner. Esse parâmetro é omitido se o contêiner não foi encerrado.  
`Limits`  
Os limites de recursos especificados no nível do contêiner, como CPU (expresso em unidades de CPU) e memória. Esse parâmetro será omitido se não houver nenhum limite de recurso definido.  
`CreatedAt`  
O time stamp de quando o contêiner foi criado. Esse parâmetro será omitido se o contêiner ainda não tiver sido criado.  
`StartedAt`  
O time stamp de quando o contêiner foi iniciado. Esse parâmetro será omitido se o contêiner ainda não tiver sido iniciado.  
`FinishedAt`  
O time stamp de quando o contêiner foi interrompido. Esse parâmetro será omitido se o contêiner ainda não tiver sido interrompido.  
`Type`  
O tipo do contêiner. Os contêineres que são especificados em sua definição de tarefa são do tipo `NORMAL`. É possível ignorar outros tipos de contêineres, que são usados para o provisionamento de recursos de tarefas internas pelo agente de contêiner do Amazon ECS.  
`LogDriver`  
O driver de log que o contêiner está usando.  
Esses metadados `LogDriver` estão incluídos somente quando é usada a versão `1.45.0` ou posterior do agente de contêiner do Linux do Amazon ECS.  
`LogOptions`  
As opções de driver de log definidas para o contêiner.  
Esses metadados `LogOptions` estão incluídos somente quando é usada a versão `1.45.0` ou posterior do agente de contêiner do Linux do Amazon ECS.  
`ContainerARN`  
O nome do recurso da Amazon (ARN) do contêiner.  
Esses metadados `ContainerARN` estão incluídos somente quando é usada a versão `1.45.0` ou posterior do agente de contêiner do Linux do Amazon ECS.  
`Networks`  
As informações de rede para o contêiner, como o modo de rede e o endereço IP. Esse parâmetro será omitido se não houver informações de rede definidas.  
`Snapshotter`  
O snapshotter que foi usado pelo containerd para baixar essa imagem do contêiner. Os valores válidos são `overlayfs`, que é o padrão, e `soci`, usado no carregamento lento com um índice SOCI. Este parâmetro só está disponível para tarefas executadas na versão da plataforma Linux `1.4.0`.  
`RestartCount`  
O número de vezes que um contêiner foi reiniciado.  
Os metadados de `RestartCount` são incluídos somente se uma política de reinicialização estiver habilitada para o contêiner. Para obter mais informações, consulte [Reiniciar contêineres individuais em tarefas do Amazon ECS com políticas de reinicialização de contêineres](container-restart-policy.md).

`ClockDrift`  
A informação sobre a diferença entre o tempo de referência e a hora do sistema. Esse recurso usa o Serviço de Sincronização Temporal da Amazon para medir a precisão do relógio e fornecer o erro de relógio vinculado aos contêineres. Para obter mais informações, consulte [Definir a hora da instância do Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-time.html) no *Guia do usuário do Amazon EC2 para instâncias do Linux*.    
`ReferenceTime`  
A base da precisão do relógio. O Amazon ECS usa o padrão global Coordinated Universal Time (UTC — Tempo universal coordenado) por meio do NTP, por exemplo, `2021-09-07T16:57:44Z`.  
`ClockErrorBound`  
A medida do erro do relógio, definida como o deslocamento para UTC. Esse erro é a diferença em milissegundos entre o tempo de referência e a hora do sistema.  
`ClockSynchronizationStatus`  
Indica se a tentativa de sincronização mais recente entre a hora do sistema e o horário de referência obteve êxito.  
Os valores válidos são `SYNCHRONIZED` e ` NOT_SYNCHRONIZED`.

`ExecutionStoppedAt`  
O time stamp de quando o `DesiredStatus` da tarefa mudou para `STOPPED`. Isso ocorre quando um contêiner essencial muda para `STOPPED`.