Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 JSON 응답 - Amazon Elastic Container Service

Fargate의 작업에 대한 Amazon ECS 작업 메타데이터 v4 JSON 응답

다음 메타데이터가 작업 메타데이터 엔드포인트(${ECS_CONTAINER_METADATA_URI_V4}/task) JSON 응답에서 반환됩니다.

Cluster

태스크가 속한 Amazon ECS 클러스터의 Amazon 리소스 이름(ARN) 또는 약어입니다.

VPCID

Amazon EC2 컨테이너 인스턴스의 VPC ID입니다. 이 필드는 Amazon EC2 인스턴스에 대해서만 표시됩니다.

참고

VPCID 메타데이터는 Amazon ECS 컨테이너 버전 1.63.1 이상을 사용할 때만 포함됩니다.

TaskARN

컨테이너가 속한 태스크의 Amazon 리소스 이름(ARN)입니다.

Family

태스크에 대한 Amazon ECS 태스크 정의의 패밀리입니다.

Revision

작업에 대한 Amazon ECS 태스크 정의의 개정입니다.

DesiredStatus

Amazon ECS의 태스크에 대해 원하는 상태입니다.

KnownStatus

Amazon ECS의 태스크에 대해 알려진 상태입니다.

Limits

작업 수준에서 지정된 리소스 제한입니다(예: CPU(vCPU로 표시) 및 메모리). 리소스 제한이 정의되지 않은 경우 이 파라미터가 생략됩니다.

PullStartedAt

첫 번째 컨테이너 이미지 풀이 시작된 시간에 대한 타임스탬프입니다.

PullStoppedAt

마지막 컨테이너 이미지 풀이 완료된 시간에 대한 타임스탬프입니다.

AvailabilityZone

태스크가 위치한 가용 영역입니다.

참고

가용 영역 메타데이터는 플랫폼 버전 1.4 이상(Linux) 또는 1.0.0(Windows)을 사용하는 Fargate 태스크에만 사용할 수 있습니다.

LaunchType

태스크에서 사용 중인 시작 유형. 클러스터 용량 공급자를 사용할 경우 해당 태스크가 Fargate 또는 EC2 인프라를 사용한다는 것을 의미합니다.

참고

LaunchType 메타데이터는 Amazon ECS Linux 컨테이너 에이전트 버전 1.45.0 이상(Linux) 또는 1.0.0 이상(Windows)을 사용할 때만 포함됩니다.

EphemeralStorageMetrics

이 작업의 임시 스토리지에 대한 예약된 크기와 현재 사용량입니다.

참고

Fargate는 디스크 공간을 예약합니다. Fargate에서만 사용됩니다. 이에 대한 요금은 청구되지 않습니다. 이러한 지표에는 표시되지 않습니다. 그러나 df 등의 다른 도구에서는 이 추가 스토리지를 볼 수 있습니다.

Utilized

이 작업의 현재 임시 스토리지 사용량(MiB)입니다.

Reserved

이 작업의 예약된 임시 스토리지(MiB)입니다. 임시 스토리지의 크기는 실행 중인 작업에서 변경할 수 없습니다. 작업 정의에서 ephermalStorage 객체를 지정하여 임시 스토리지의 양을 변경할 수 있습니다. ephermalStorage는 MiB가 아닌 GiB 단위로 지정됩니다. ephermalStorageEphemeralStorageMetrics는 Fargate Linux 플랫폼 버전 1.4.0 이상에서만 사용할 수 있습니다.

Containers

태스크와 연결된 각 컨테이너에 대한 컨테이너 메타데이터의 목록입니다.

DockerId

컨테이너의 Docker ID입니다.

Fargate를 사용할 때 ID는 32자리 16진수이고 그 뒤에 10자리 숫자가 붙습니다.

Name

태스크 정의에 지정된 컨테이너의 이름입니다.

DockerName

Docker에 제공된 컨테이너의 이름입니다. 동일한 태스크 정의의 여러 복사본이 단일 인스턴스에서 실행될 때 이름 충돌을 방지하기 위해 Amazon ECS 컨테이너 에이전트는 컨테이너에 고유의 이름을 생성합니다.

Image

컨테이너에 대한 이미지입니다.

ImageID

이미지 매니페스트의 SHA-256 다이제스트입니다. repository-url/image@sha256:digest 형식을 통해 이미지를 가져오는 데 사용할 수 있는 다이제스트입니다.

Ports

컨테이너에 대해 노출된 포트입니다. 노출된 포트가 없는 경우 이 파라미터가 생략됩니다.

Labels

컨테이너에 적용된 레이블입니다. 적용된 레이블이 없는 경우 이 파라미터가 생략됩니다.

DesiredStatus

Amazon ECS의 컨테이너에 대해 원하는 상태입니다.

KnownStatus

Amazon ECS의 컨테이너에 대해 알려진 상태입니다.

ExitCode

컨테이너에 대한 종료 코드입니다. 컨테이너가 종료되지 않은 경우 이 파라미터가 생략됩니다.

Limits

컨테이너 수준에서 지정된 리소스 제한입니다(예: CPU(CPU 단위로 표시) 및 메모리). 리소스 제한이 정의되지 않은 경우 이 파라미터가 생략됩니다.

CreatedAt

컨테이너가 생성된 시간에 대한 타임스탬프입니다. 컨테이너가 아직 생성되지 않은 경우 이 파라미터가 생략됩니다.

StartedAt

컨테이너가 시작된 시간에 대한 타임스탬프입니다. 컨테이너가 아직 시작되지 않은 경우 이 파라미터가 생략됩니다.

FinishedAt

컨테이너가 중지된 시간에 대한 타임스탬프입니다. 컨테이너가 아직 중지되지 않은 경우 이 파라미터가 생략됩니다.

Type

컨테이너의 유형입니다. 태스크 정의에서 지정된 컨테이너는 NORMAL 유형입니다. Amazon ECS 컨테이너 에이전트가 내부 작업 리소스 프로비저닝에 사용하는 기타 컨테이너 유형은 무시할 수 있습니다.

LogDriver

컨테이너가 사용하는 로그 드라이버입니다.

참고

LogDriver 메타데이터는 Amazon ECS Linux 컨테이너 버전 1.45.0 이상을 사용할 때만 포함됩니다.

LogOptions

컨테이너에 정의된 로그 드라이버 옵션입니다.

참고

LogOptions 메타데이터는 Amazon ECS Linux 컨테이너 버전 1.45.0 이상을 사용할 때만 포함됩니다.

ContainerARN

컨테이너의 Amazon 리소스 이름(ARN)입니다.

참고

ContainerARN 메타데이터는 Amazon ECS Linux 컨테이너 버전 1.45.0 이상을 사용할 때만 포함됩니다.

Networks

컨테이너에 대한 네트워크 정보(예: 네트워크 모드 및 IP 주소)입니다. 네트워크 정보가 정의되지 않은 경우 이 파라미터가 생략됩니다.

Snapshotter

containerd가 이 컨테이너 이미지를 다운로드하는 사용한 snapshotter입니다. 유효한 값은 기본값인 overlayfs 및 SOCI 인덱스로 지연 로드할 때 사용되는 soci입니다. 이 파라미터는 Linux 플랫폼 버전 1.4.0에서 실행되는 작업에만 사용할 수 있습니다.

RestartCount

컨테이너가 재시작된 횟수입니다.

참고

RestartCount 메타데이터는 컨테이너에 대해 재시작 정책이 활성화된 경우에만 포함됩니다. 자세한 정보는 컨테이너 재시작 정책이 있는 Amazon ECS 작업의 개별 컨테이너 재시작을 참조하세요.

ClockDrift

기준 시간과 시스템 시간의 차이에 대한 정보입니다. 이 기능은 Amazon Time Sync Service를 사용하여 클럭 정확도를 측정하고 컨테이너에 대한 클록 오류 범위를 제공합니다. 자세한 내용은 Amazon EC2 Linux용 사용 설명서의 Linux 인스턴스에 대한 시간 설정을 참조하세요.

ReferenceTime

클록 정확도의 기초입니다. Amazon ECS는 NTP를 통해 협정 세계시(UTC) 글로벌 표준을 사용합니다(예: 2021-09-07T16:57:44Z).

ClockErrorBound

UTC에 대한 오프셋으로 정의되는 클록 오류 측정값입니다. 이 오류는 기준 시간과 시스템 시간의 차이(밀리초)입니다.

ClockSynchronizationStatus

시스템 시간과 기준 시간 간의 가장 최근 동기화 시도가 성공했는지를 나타냅니다.

유효 값은 SYNCHRONIZED NOT_SYNCHRONIZED입니다.

ExecutionStoppedAt

태스크의 DesiredStatusSTOPPED로 이동한 시간에 대한 타임스탬프입니다. 이 동작은 필수 컨테이너가 STOPPED로 이동할 때 발생합니다.