From c7995b7d4b87e1023a811cb76a4daea14c496d2d Mon Sep 17 00:00:00 2001 From: James Bardin Date: Tue, 23 Feb 2021 10:30:24 -0500 Subject: [PATCH] update show -json docs --- website/docs/cli/commands/show.html.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/website/docs/cli/commands/show.html.md b/website/docs/cli/commands/show.html.md index 3c78d6d00..45bc6fa3f 100644 --- a/website/docs/cli/commands/show.html.md +++ b/website/docs/cli/commands/show.html.md @@ -28,6 +28,12 @@ For Terraform state files (including when no path is provided), For Terraform plan files, `terraform show -json` will show a JSON representation of the plan, configuration, and current state. +If you've updated providers which contain new schema versions since the state +was written, the state needs to be upgraded before it can be displayed with +`show -json`. If you are viewing a plan, it must be created without +`-refresh=false`. If you are viewing a state file, run `terraform refresh` +first. + The output format is covered in detail in [JSON Output Format](/docs/internals/json-format.html). ## Usage