AWS

Download 575
Last updated Nov 20, 2026

aws-ecs-services

Retrieves a list of AWS ECS services.

Syntax

aws-ecs-services [profile=PROFILE] [region=REGION] [cluster=CLUSTER]

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.

Output Fields

FieldTypeNameDescription
aws_profileStringConnect profileThe identifier of AWS connect profile
regionStringRegione.g. ap-northeast-2
cluster_nameStringCluster namee.g. prod-cluster
service_nameStringService namee.g. web-api
service_arnStringService ARN
statusStringStatuse.g. ACTIVE, DRAINING, INACTIVE
launch_typeStringLaunch typee.g. FARGATE, EC2, EXTERNAL
platform_versionStringPlatform versionFargate platform version, e.g. 1.4.0
platform_familyStringPlatform familye.g. Linux, Windows
task_definitionStringTask definitionTask definition ARN
desired_countIntegerDesired count
running_countIntegerRunning countCompare with desired_count to detect degraded services
pending_countIntegerPending count
scheduling_strategyStringScheduling strategye.g. REPLICA, DAEMON
deployment_controllerStringDeployment controllere.g. ECS, CODE_DEPLOY, EXTERNAL
role_arnStringRole ARN
created_atDateCreated at
created_byStringCreated by
propagate_tagsStringPropagate tagse.g. TASK_DEFINITION, SERVICE
enable_execute_commandBoolECS Exec enabled
health_check_grace_period_secIntegerHealth check grace period
assign_public_ipStringAssign public IPe.g. ENABLED, DISABLED
subnetsListSubnetsSubnet IDs of awsvpc network configuration
security_groupsListSecurity groupsSecurity group IDs of awsvpc network configuration
capacity_provider_strategyListCapacity provider strategyElements with capacity_provider, weight, and base properties
load_balancersListLoad balancersElements with target_group_arn, load_balancer_name, container_name, and container_port properties
service_registriesListService registriesElements with registry_arn, port, container_name, and container_port properties
deploymentsListDeploymentsElements with id, status, task_definition, desired_count, running_count, pending_count, failed_tasks, rollout_state, rollout_state_reason, created_at, and updated_at properties
tagsListTagsElements with key and value properties