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 |
| revision | 32비트 정수 | 태스크 정의 리비전 | 예: 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_gb | 32비트 정수 | 임시 스토리지 크기 | 단위: GiB |
| private_ip | IP 주소 | 사설 IP | 태스크의 ElasticNetworkInterface 연결 정보에서 추출 |
| eni_id | 문자열 | ENI ID | 예: eni-00123456789abcdef |
| subnet_id | 문자열 | 서브넷 ID | |
| mac_address | 문자열 | MAC 주소 | |
| private_dns_name | 문자열 | 사설 DNS 이름 | |
| container_instance_arn | 문자열 | 컨테이너 인스턴스 ARN | Fargate 태스크는 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 속성 포함 |