Resposta JSON para metadados de tarefas v4 no Amazon ECS para tarefas no Fargate - Amazon Elastic Container Service

Resposta JSON para metadados de tarefas v4 no Amazon ECS para tarefas no Fargate

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.

VPCID

O ID da VPC da instância de contêiner do Amazon EC2. Esse campo é exibido somente para instâncias do Amazon EC2.

nota

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 de 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á.

nota

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.

nota

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.

nota

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 para a imagem.

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.

nota

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.

nota

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 completo do recurso da Amazon (ARN) do contêiner.

nota

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.

nota

Os metadados de RestartCount são incluídos somente se uma política de reinicialização estiver habilitada para o contêiner. Para ter mais informações, consulte Reiniciar contêineres individuais em tarefas do Amazon ECS com políticas de reinicialização de contêineres.

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