AWS

Download 575
Last updated Nov 20, 2026

aws-ecs-tasks

Retrieves a list of AWS ECS tasks including Fargate tasks.

Syntax

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

Options

profile=PROFILE
Optional. The identifier of AWS connect profile
region=REGION
Optional. AWS region
cluster=CLUSTER
Optional. Comma separated ECS cluster names or ARNs. All clusters are queried if omitted.
service=SERVICE
Optional. ECS service name to filter tasks
status=STATUS
Optional. RUNNING (default), PENDING, STOPPED, or ALL. ALL queries every status and merges the result. Note that STOPPED returns only tasks stopped within the last hour.

Output Fields

FieldTypeNameDescription
aws_profileStringConnect profileThe identifier of AWS connect profile
regionStringRegione.g. ap-northeast-2
cluster_nameStringCluster namee.g. prod-cluster
task_idStringTask IDThe last segment of the task ARN
task_arnStringTask ARN
service_nameStringService nameDerived from the task group. Null for tasks not managed by a service.
groupStringTask groupe.g. service:web-api, family:batch-job
familyStringTask definition familye.g. web-api
revisionIntegerTask definition revisione.g. 7
task_definition_arnStringTask definition ARN
launch_typeStringLaunch typee.g. FARGATE, EC2, EXTERNAL
capacity_providerStringCapacity providere.g. FARGATE, FARGATE_SPOT
platform_versionStringPlatform versionFargate platform version, e.g. 1.4.0
platform_familyStringPlatform familye.g. Linux, Windows
azStringAvailability Zonee.g. ap-northeast-2a
desired_statusStringDesired statuse.g. RUNNING, STOPPED
last_statusStringLast statuse.g. PROVISIONING, PENDING, RUNNING, STOPPED
health_statusStringHealth statuse.g. HEALTHY, UNHEALTHY, UNKNOWN
connectivityStringConnectivitye.g. CONNECTED, DISCONNECTED
cpuStringCPU unitse.g. 256, 1024
memoryStringMemoryUnit: MiB. e.g. 512, 2048
ephemeral_storage_gbIntegerEphemeral storageUnit: GiB
private_ipIP addressPrivate IPExtracted from the ElasticNetworkInterface attachment of the task
eni_idStringENI IDe.g. eni-00123456789abcdef
subnet_idStringSubnet ID
mac_addressStringMAC address
private_dns_nameStringPrivate DNS name
container_instance_arnStringContainer instance ARNNull for Fargate tasks
enable_execute_commandBoolECS Exec enabled
created_atDateCreated at
started_atDateStarted at
started_byStringStarted by
connectivity_atDateConnectivity at
pull_started_atDateImage pull started at
pull_stopped_atDateImage pull stopped at
execution_stopped_atDateExecution stopped at
stopping_atDateStopping at
stopped_atDateStopped at
stop_codeStringStop codee.g. TaskFailedToStart, EssentialContainerExited, UserInitiated
stopped_reasonStringStopped reason
containersListContainersElements with name, container_arn, image, image_digest, runtime_id, last_status, health_status, exit_code, reason, cpu, memory, memory_reservation, and private_ip properties
tagsListTagsElements with key and value properties