pcluster delete - Amazon ParallelCluster
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 (PDF).

pcluster delete

Deletes a cluster.

pcluster delete [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name

Positional arguments


Specifies the name of the cluster to delete.

Named arguments

-h, --help

Shows the help text for pcluster delete.


Specifies the alternative configuration file to use.

Defaults to ~/.parallelcluster/config.


Keep the CloudWatch Logs data after deleting the cluster. The log group remains until you delete it manually, but the log events expire based on the retention_days setting. The setting defaults to 14 days.


Support for the --keep-logs argument was added in Amazon ParallelCluster version 2.6.0.

-r REGION, --region REGION

Specifies the Amazon Web Services Region to use. Defaults to the Amazon Web Services Region specified by using the pcluster configure command.

When the command is called and begins polling for the status of that call, it's safe to use "Ctrl-C" to exit. You can return to viewing the current status by calling pcluster status mycluster.

Example using Amazon ParallelCluster version 2.11.7:

$ pcluster delete -c path/to/config -r us-east-1 mycluster Deleting: mycluster Status: RootRole - DELETE_COMPLETE Cluster deleted successfully.

To delete the network resources in the VPC, you can delete the CloudFormation networking stack. The stack name starts with "parallelclusternetworking-" and contains the creation time in "YYYYMMDDHHMMSS" format. You can list the stacks using the list-stacks command.

$ aws --region us-east-1 cloudformation list-stacks \ --stack-status-filter "CREATE_COMPLETE" \ --query "StackSummaries[].StackName" | \ grep -e "parallelclusternetworking-" "parallelclusternetworking-pubpriv-20191029205804"

The stack can be deleted using the delete-stack command.

$ aws --region us-east-1 cloudformation delete-stack \ --stack-name parallelclusternetworking-pubpriv-20191029205804

The VPC that pcluster configure creates for you is not created in the CloudFormation networking stack. You can delete that VPC manually in the console or by using the Amazon CLI.

$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad