github.com/vtorhonen/terraform@v0.9.0-beta2.0.20170307220345-5d894e4ffda7/website/source/docs/commands/env/delete.html.md (about)

     1  ---
     2  layout: "commands-env"
     3  page_title: "Command: env delete"
     4  sidebar_current: "docs-env-sub-delete"
     5  description: |-
     6    The terraform env delete command is used to create a delete state environment.
     7  ---
     8  
     9  # Command: env delete
    10  
    11  The `terraform env delete` command is used to delete an existing environment.
    12  
    13  ## Usage
    14  
    15  Usage: `terraform env delete [NAME]`
    16  
    17  This command will delete the specified environment.
    18  
    19  To delete an environment, it must already exist, it must be empty, and
    20  it must not be your current environment. If the environment
    21  is not empty, Terraform will not allow you to delete it without the
    22  `-force` flag.
    23  
    24  If you delete a non-empty state (via force), then resources may become
    25  "dangling". These are resources that Terraform no longer manages since
    26  a state doesn't point to them, but still physically exist. This is sometimes
    27  preferred: you want Terraform to stop managing resources. Most of the time,
    28  however, this is not intended so Terraform protects you from doing this.
    29  
    30  The command-line flags are all optional. The list of available flags are:
    31  
    32  * `-force` - Delete the state even if non-empty. Defaults to false.
    33  
    34  ## Example
    35  
    36  ```
    37  $ terraform env delete example
    38  Deleted environment "example"!
    39  ```