Deleting a cluster using the classic console - Amazon Elastic Container Service
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Deleting a cluster using the classic console

If you are finished using a cluster, you can delete it. After you delete the cluster, it transitions to the INACTIVE state. Clusters with an INACTIVE status may remain discoverable in your account for a period of time. However, this behavior is subject to change in the future, so you should not rely on INACTIVE clusters persisting.

When you delete a cluster in the Amazon ECS console, the associated resources that are deleted with it vary depending on how the cluster was created. This condition is discussed in step 5 of the following procedure.

If your cluster was created with the Amazon Web Services Management Console then the Amazon CloudFormation stack that was created for your cluster is also deleted when you delete your cluster. If you have added or modified the underlying cluster resources you may receive an error when attempting to delete the cluster. Amazon CloudFormation refers to this as stack drift. For more information on detecting drift on an existing Amazon CloudFormation stack, see Detect drift on an entire Amazon CloudFormation stack in the Amazon CloudFormation User Guide.

To delete a cluster using the classic console

  1. Open the Amazon ECS console at https://console.amazonaws.cn/ecs/.

  2. From the navigation bar, select the Region to use.

  3. In the navigation pane, choose Clusters.

  4. On the Clusters page, select the cluster to delete.

    Note

    If your cluster has registered container instances, you must deregister or terminate them. For more information, see Deregister an Amazon EC2 backed container instance.

  5. In the upper-right of the page, choose Delete Cluster. You see one of two confirmation prompts:

    • Deleting the cluster also deletes the Amazon CloudFormation stack EC2ContainerService-cluster_name Deleting this cluster cleans up the associated resources that were created with the cluster, including Auto Scaling groups, VPCs, or load balancers.

    • Deleting the cluster does not affect Amazon CloudFormation resources – Deleting this cluster does not clean up any resources that are associated with the cluster, including Auto Scaling groups, VPCs, or load balancers. Also, any container instances that are registered with this cluster must be deregistered or terminated before you can delete the cluster. For more information, see Deregister an Amazon EC2 backed container instance. You can visit the Amazon CloudFormation console at https://console.amazonaws.cn/cloudformation/ to update or delete any of these resources.

  6. In the confirmation box, enter delete me.