v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1456373564.1 KB

Deletes the specified cluster. The cluster transitions to the INACTIVE state. Clusters with an INACTIVE status might remain discoverable in your account for a period of time. However, this behavior is subject to change in the future. We don't recommend that you rely on INACTIVE clusters persisting.

You must deregister all container instances from this cluster before you may delete it. You can list the container instances in a cluster with ListContainerInstances and deregister them with DeregisterContainerInstance.

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

Headers

X-Amz-Target'AmazonEC2ContainerServiceV20141113.DeleteCluster' required

Request body

clusterstring required

The short name or full Amazon Resource Name (ARN) of the cluster to delete.

Response

Success

Example response

{
  "cluster": {
    "activeServicesCount": 0,
    "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster",
    "clusterName": "my_cluster",
    "pendingTasksCount": 0,
    "registeredContainerInstancesCount": 0,
    "runningTasksCount": 0,
    "status": "INACTIVE"
  }
}