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

As seguintes informações são retornadas da resposta em JSON (`${ECS_CONTAINER_METADATA_URI_V4}/task`) do endpoint de metadados de tarefas. Isso inclui metadados associados à tarefa, além dos metadados de cada contêiner dentro 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. Será exibido ServiceName para instâncias de contêiner do Amazon EC2 e do Amazon ECS Anywhere, se a tarefa estiver associada a um serviço.  
Os metadados `ServiceName` são incluídos somente quando é usada a versão `1.63.1` ou posterior do agente de contêiner do Amazon ECS.

`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 no nível 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.

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

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