Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456373564.1 KB

Describes one or more of your clusters.

post/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeClusters

Headers

X-Amz-Target'AmazonEC2ContainerServiceV20141113.DescribeClusters' required

Request body

clustersString[]

A list of up to 100 cluster names or full cluster Amazon Resource Name (ARN) entries. If you do not specify a cluster, the default cluster is assumed.

includeClusterField[]
<p>Determines whether to include additional information about the clusters in the response. If this field is omitted, this information isn't included.</p> <p>If <code>ATTACHMENTS</code> is specified, the attachments for the container instances or tasks within the cluster are included, for example the capacity providers.</p> <p>If <code>SETTINGS</code> is specified, the settings for the cluster are included.</p> <p>If <code>CONFIGURATIONS</code> is specified, the configuration for the cluster is included.</p> <p>If <code>STATISTICS</code> is specified, the task and service count is included, separated by launch type.</p> <p>If <code>TAGS</code> is specified, the metadata tags associated with the cluster are included.</p>

Response

Success

Example response

{
  "clusters": [
    {
      "clusterArn": "arn:aws:ecs:us-east-1:aws_account_id:cluster/default",
      "clusterName": "default",
      "status": "ACTIVE"
    }
  ],
  "failures": []
}