ecs:ListContainerInstances

List

ecs:ListContainerInstances is a List access-level action in the ecs service. Grants permission to get a list of container instances in a specified cluster

Resource types

ARNs that ecs:ListContainerInstances can be scoped to in an IAM policy.

arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
cluster

Condition keys

Keys you can use in the Condition block of a policy that grants ecs:ListContainerInstances.

aws:ResourceTag/${TagKey} String

Filters access by the tag key-value pairs attached to the resource

ecs:ResourceTag/${TagKey} String

Filters access by the tag key-value pairs attached to the resource

Example IAM policy

A minimal policy that allows ecs:ListContainerInstances. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowEcsListContainerInstances",
      "Effect": "Allow",
      "Action": "ecs:ListContainerInstances",
      "Resource": "*"
    }
  ]
}

Related actions in ecs

View all ecs actions →