AWS

다운로드 575
업데이트 2026. 11. 20.

aws-ecs-tasks

Fargate 태스크를 포함한 AWS ECS 태스크 목록을 조회합니다.

문법

aws-ecs-tasks [profile=PROFILE] [region=REGION] [cluster=CLUSTER] [service=SERVICE] [status=STATUS]

옵션

profile=PROFILE
선택 옵션. AWS 접속 프로파일
region=REGION
선택 옵션. AWS 리전
cluster=CLUSTER
선택 옵션. 콤마로 구분된 ECS 클러스터 이름 또는 ARN. 생략하면 전체 클러스터를 조회합니다.
service=SERVICE
선택 옵션. 태스크를 필터링할 ECS 서비스 이름
status=STATUS
선택 옵션. RUNNING(기본값), PENDING, STOPPED, ALL 중 하나. ALL은 모든 상태를 조회하여 합칩니다. 단, STOPPED는 최근 1시간 이내에 종료된 태스크만 반환합니다.

출력 필드

필드타입이름설명
aws_profile문자열접속 프로파일AWS 접속 프로파일 식별자
region문자열리전예: ap-northeast-2
cluster_name문자열클러스터 이름예: prod-cluster
task_id문자열태스크 ID태스크 ARN의 마지막 구간
task_arn문자열태스크 ARN
service_name문자열서비스 이름태스크 그룹에서 추출. 서비스가 관리하지 않는 태스크는 null
group문자열태스크 그룹예: service:web-api, family:batch-job
family문자열태스크 정의 패밀리예: web-api
revision32비트 정수태스크 정의 리비전예: 7
task_definition_arn문자열태스크 정의 ARN
launch_type문자열실행 유형예: FARGATE, EC2, EXTERNAL
capacity_provider문자열용량 공급자예: FARGATE, FARGATE_SPOT
platform_version문자열플랫폼 버전Fargate 플랫폼 버전. 예: 1.4.0
platform_family문자열플랫폼 제품군예: Linux, Windows
az문자열가용 영역예: ap-northeast-2a
desired_status문자열희망 상태예: RUNNING, STOPPED
last_status문자열최종 상태예: PROVISIONING, PENDING, RUNNING, STOPPED
health_status문자열상태 검사 결과예: HEALTHY, UNHEALTHY, UNKNOWN
connectivity문자열연결 상태예: CONNECTED, DISCONNECTED
cpu문자열CPU 단위예: 256, 1024
memory문자열메모리단위: MiB. 예: 512, 2048
ephemeral_storage_gb32비트 정수임시 스토리지 크기단위: GiB
private_ipIP 주소사설 IP태스크의 ElasticNetworkInterface 연결 정보에서 추출
eni_id문자열ENI ID예: eni-00123456789abcdef
subnet_id문자열서브넷 ID
mac_address문자열MAC 주소
private_dns_name문자열사설 DNS 이름
container_instance_arn문자열컨테이너 인스턴스 ARNFargate 태스크는 null
enable_execute_command불리언ECS Exec 사용 여부
created_at날짜생성 일시
started_at날짜시작 일시
started_by문자열시작 주체
connectivity_at날짜연결 일시
pull_started_at날짜이미지 받기 시작 일시
pull_stopped_at날짜이미지 받기 완료 일시
execution_stopped_at날짜실행 종료 일시
stopping_at날짜종료 시작 일시
stopped_at날짜종료 일시
stop_code문자열종료 코드예: TaskFailedToStart, EssentialContainerExited, UserInitiated
stopped_reason문자열종료 사유
containers배열컨테이너 목록각 배열 요소는 name, container_arn, image, image_digest, runtime_id, last_status, health_status, exit_code, reason, cpu, memory, memory_reservation, private_ip 속성 포함
tags배열태그 목록각 배열 요소는 key, value 속성 포함