Amazon ECS Managed Instances 태스크용 Amazon ECS 태스크 메타데이터 v4 JSON 응답

다음 메타데이터는 태스크 메타데이터 엔드포인트(${ECS_CONTAINER_METADATA_URI_V4}/task)의 JSON 응답에서 반환됩니다.

출처: 문서

본문

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

Cluster — 태스크가 속한 Amazon ECS 클러스터의 ARN(Amazon Resource Name) 또는 짧은 이름.

ServiceName — 태스크가 속한 서비스의 이름. 태스크가 서비스와 연결되면 ServiceName이 나타납니다.

VPCID — 컨테이너 인스턴스의 VPC ID.

TaskARN — 컨테이너가 속한 태스크의 ARN.

Family — 태스크의 Amazon ECS 태스크 정의 패밀리.

Revision — 태스크의 Amazon ECS 태스크 정의 리비전.

DesiredStatus — Amazon ECS의 태스크 desired status.

KnownStatus — Amazon ECS의 태스크 known status.

Limits — vCPU로 표현된 CPU와 메모리 같은 태스크 수준에서 지정된 리소스 한도. 리소스 한도가 정의되지 않으면 이 파라미터는 생략됩니다.

PullStartedAt — 첫 번째 컨테이너 이미지 풀이 시작된 타임스탬프.

PullStoppedAt — 마지막 컨테이너 이미지 풀이 완료된 타임스탬프.

AvailabilityZone — 태스크가 있는 Availability Zone.

LaunchType — 태스크가 사용하는 실행 유형. Amazon ECS Managed Instances에서 실행되는 태스크의 실행 유형은 MANAGED_INSTANCES입니다.

Containers — 태스크와 연결된 각 컨테이너의 컨테이너 메타데이터 목록.

DockerId — 컨테이너의 Docker ID. Amazon ECS Managed Instances를 사용할 때 ID는 32자리 16진수 뒤에 10자리 숫자가 붙습니다.

Name — 태스크 정의에 지정된 컨테이너 이름.

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

Image — 컨테이너의 이미지.

ImageID — 이미지 매니페스트의 SHA-256 다이제스트. repository-url/image@sha256:digest 형식으로 이미지를 풀하는 데 사용할 수 있는 다이제스트입니다.

Ports — 컨테이너에 노출된 모든 포트. 노출된 포트가 없으면 생략됩니다.

Labels — 컨테이너에 적용된 모든 라벨. 적용된 라벨이 없으면 생략됩니다.

DesiredStatus — Amazon ECS의 컨테이너 desired status.

KnownStatus — Amazon ECS의 컨테이너 known status.

ExitCode — 컨테이너의 종료 코드. 컨테이너가 종료되지 않았으면 생략됩니다.

Limits — CPU 단위로 표현된 CPU와 메모리 같은 컨테이너 수준에서 지정된 리소스 한도. 리소스 한도가 정의되지 않으면 생략됩니다.

CreatedAt — 컨테이너가 생성된 타임스탬프. 컨테이너가 아직 생성되지 않았으면 생략됩니다.

StartedAt — 컨테이너가 시작된 타임스탬프. 컨테이너가 아직 시작되지 않았으면 생략됩니다.

FinishedAt — 컨테이너가 중지된 타임스탬프. 컨테이너가 아직 중지되지 않았으면 생략됩니다.

Type — 컨테이너의 유형. 태스크 정의에 지정된 컨테이너는 NORMAL 유형입니다. Amazon ECS 컨테이너 에이전트가 내부 태스크 리소스 프로비저닝에 사용하는 다른 컨테이너 유형은 무시해도 됩니다.

LogDriver — 컨테이너가 사용하는 로그 드라이버.

LogOptions — 컨테이너에 정의된 로그 드라이버 옵션.

ContainerARN — 컨테이너의 ARN.

Networks — 네트워크 모드와 IP 주소 같은 컨테이너의 네트워크 정보. 네트워크 정보가 정의되지 않으면 생략됩니다.

Snapshotter — containerd가 이 컨테이너 이미지를 다운로드하는 데 사용한 스냅샷터. 유효한 값은 기본값인 overlayfs와, SOCI 인덱스로 지연 로딩(lazy loading)할 때 사용하는 soci입니다.

RestartCount — 컨테이너가 재시작된 횟수.

참고: RestartCount 메타데이터는 컨테이너에 재시작 정책이 활성화된 경우에만 포함됩니다. 자세한 내용은 "Restart individual containers in Amazon ECS tasks with container restart policies"를 참고하세요.

ClockDrift — 참조 시간(reference time)과 시스템 시간의 차이에 대한 정보. 이 기능은 Amazon Time Sync Service를 사용해 클럭 정확도를 측정하고 컨테이너의 클럭 오류 범위를 제공합니다. 자세한 내용은 Amazon EC2 User Guide for Linux instances의 "Set the time for your Linux instance"를 참고하세요.

ReferenceTime — 클럭 정확도의 기준. Amazon ECS는 NTP를 통해 국제 표준인 UTC(Coordinated Universal Time)를 사용합니다. 예: 2021-09-07T16:57:44Z.

ClockErrorBound — UTC에 대한 오프셋으로 정의된 클럭 오류 측정치. 이 오류는 참조 시간과 시스템 시간 사이의 밀리초 차이입니다.

ClockSynchronizationStatus — 시스템 시간과 참조 시간 사이의 가장 최근 동기화 시도가 성공했는지를 나타냅니다. 유효한 값은 SYNCHRONIZED와 NOT_SYNCHRONIZED입니다.

ExecutionStoppedAt — 태스크의 DesiredStatus가 STOPPED로 이동한 타임스탬프. 이는 필수(essential) 컨테이너가 STOPPED로 이동할 때 발생합니다.

FaultInjectionEnabled — 태스크에 대해 결함 주입(fault injection)이 활성화되었는지를 나타냅니다. 자세한 내용은 "Use fault injection with your Amazon ECS and Fargate workloads"를 참고하세요.

더 알아보기 (Learn more)

태스크 메타데이터 엔드포인트 v4에 대한 자세한 내용은 AWS 공식 문서를 참고해 주세요.