github.com/rstandt/terraform@v0.12.32-0.20230710220336-b1063613405c/website/docs/commands/show.html.markdown (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Command: show"
     4  sidebar_current: "docs-commands-show"
     5  description: |-
     6    The `terraform show` command is used to provide human-readable output from a state or plan file. This can be used to inspect a plan to ensure that the planned operations are expected, or to inspect the current state as Terraform sees it.
     7  ---
     8  
     9  # Command: show
    10  
    11  The `terraform show` command is used to provide human-readable output
    12  from a state or plan file. This can be used to inspect a plan to ensure
    13  that the planned operations are expected, or to inspect the current state
    14  as Terraform sees it.
    15  
    16  Machine-readable output is generated by adding the `-json` command-line
    17  flag.
    18  
    19  -> **Note:** When using the `-json` command-line flag, any sensitive values in
    20  Terraform state will be displayed in plain text. For more information, see
    21  [Sensitive Data in State](/docs/state/sensitive-data.html).
    22  
    23  ## JSON Output
    24  
    25  For Terraform state files (including when no path is provided),
    26  `terraform show -json` will show a JSON representation of the state.
    27  
    28  For Terraform plan files, `terraform show -json` will show a JSON representation
    29  of the plan, configuration, and current state.
    30  
    31  The output format is covered in detail in [JSON Output Format](/docs/internals/json-format.html).
    32  
    33  ## Usage
    34  
    35  Usage: `terraform show [options] [path]`
    36  
    37  You may use `show` with a path to either a Terraform state file or plan
    38  file. If no path is specified, the current state will be shown.
    39  
    40  The command-line flags are all optional. The list of available flags are:
    41  
    42  * `-no-color` - Disables output with coloring
    43  
    44  * `-json` - Displays machine-readable output from a state or plan file
    45  
    46  -> JSON output via the `-json` option requires **Terraform v0.12 or later**.