This is the AWS CDK v2 Developer Guide. The older CDK v1 entered maintenance on June 1, 2022 and ended support on June 1, 2023.
cdk destroy
Delete one or more AWS CDK stacks from your AWS environment.
When you delete a stack, resources in the stack will be destroyed, unless they were configured with a DeletionPolicy of Retain.
During stack deletion, this command will output progress information similar to cdk deploy behavior.
Usage
$ cdk destroy <arguments> <options>
Arguments
- CDK stack ID
-
The construct ID of the CDK stack from your app to delete.
Type: String
Required: No
Options
For a list of global options that work with all CDK CLI commands, see Global options.
-
--all <BOOLEAN> -
Destroy all available stacks.
Default value:
false
-
--concurrency <NUMBER> -
Destroy multiple stacks in parallel while accounting for inter-stack dependencies. Use this option to speed up destroy operations. You must still factor in AWS CloudFormation and other AWS account rate limiting.
Provide a number to specify the maximum number of simultaneous destroy operations (dependency permitting) to perform.
Default value:
1
-
--exclusively, -e <BOOLEAN> -
Only destroy requested stacks and don’t include dependencies.
-
--express <BOOLEAN> -
Destroy stacks using CloudFormation express mode. Express mode allows for faster deletions through CloudFormation by reporting stack operations as completed as soon as CloudFormation applies the resource configuration. However, CloudFormation reports success without waiting for resources to stabilize. Additionally, express mode does not perform rollback automatically and will leave stacks in a failed state if something goes wrong.
For more information, see express mode in the AWS CloudFormation User Guide.
Note
Express mode does not wait for stabilization before reporting success and does not perform automatic rollback upon failure. We do not recommend express mode for production stack teardown. Express mode is targeted towards iterative deployments you would perform while developing your application.
Default value:
false
-
--force, -f <BOOLEAN> -
Do not ask for confirmation before destroying the stacks.
-
--help, -h <BOOLEAN> -
Show command reference information for the
cdk destroycommand.
Examples
Delete a stack named MyStackName
$ cdk destroy --app='node bin/main.js' <MyStackName>
Delete multiple stacks in parallel
Use the --concurrency option with --all to delete all stacks in parallel:
$ cdk destroy --all --concurrency 5
