mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-03-10 10:01:16 -04:00
6d80088f51
While we were working on and documenting these it wasn't clear exactly what Terraform CLI version they would land in, and so we used "Terraform v1.0" in the docs as a safe bound that was definitely going to include all of them. With everything now landed though, we can be more specific about which v0.15.x minor release each of these appeared in.
49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
---
|
|
layout: "docs"
|
|
page_title: "Command: destroy"
|
|
sidebar_current: "docs-commands-destroy"
|
|
description: |-
|
|
The `terraform destroy` command is a convenient way to destroy all objects
|
|
managed by a particular Terraform configuration.
|
|
---
|
|
|
|
# Command: destroy
|
|
|
|
The `terraform destroy` command is a convenient way to destroy all remote
|
|
objects managed by a particular Terraform configuration.
|
|
|
|
While you will typically not want to destroy long-lived objects in a production
|
|
environment, Terraform is sometimes used to manage ephemeral infrastructure
|
|
for development purposes, in which case you can use `terraform destroy` to
|
|
conveniently clean up all of those temporary objects once you are finished
|
|
with your work.
|
|
|
|
## Usage
|
|
|
|
Usage: `terraform destroy [options]`
|
|
|
|
This command is just a convenience alias for the following command:
|
|
|
|
```
|
|
terraform apply -destroy
|
|
```
|
|
|
|
For that reason, this command accepts most of the options that
|
|
[`terraform apply`](./apply.html) accepts, although it does
|
|
not accept a plan file argument and forces the selection of the "destroy"
|
|
planning mode.
|
|
|
|
You can also create a speculative destroy plan, to see what the effect of
|
|
destroying would be, by running the following command:
|
|
|
|
```
|
|
terraform plan -destroy
|
|
```
|
|
|
|
This will run [`terraform plan`](./plan.html) in _destroy_ mode, showing
|
|
you the proposed destroy changes without executing them.
|
|
|
|
-> **Note:** The `-destroy` option to `terraform apply` exists only in
|
|
Terraform v0.15.2 and later. For earlier versions, you _must_ use
|
|
`terraform destroy` to get the effect of `terraform apply -destroy`.
|