diff --git a/command/state_show.go b/command/state_show.go index 00c97816ed..0f1b7285c0 100644 --- a/command/state_show.go +++ b/command/state_show.go @@ -63,7 +63,9 @@ func (c *StateShowCommand) Run(args []string) int { output := make([]string, 0, len(is.Attributes)+1) output = append(output, fmt.Sprintf("id | %s", is.ID)) for _, k := range keys { - output = append(output, fmt.Sprintf("%s | %s", k, is.Attributes[k])) + if k != "id" { + output = append(output, fmt.Sprintf("%s | %s", k, is.Attributes[k])) + } } // Output diff --git a/website/source/docs/commands/state/list.html.md b/website/source/docs/commands/state/list.html.md index da63da34b9..a571d6ff5f 100644 --- a/website/source/docs/commands/state/list.html.md +++ b/website/source/docs/commands/state/list.html.md @@ -3,7 +3,7 @@ layout: "commands-state" page_title: "Command: state list" sidebar_current: "docs-state-sub-list" description: |- - The `terraform init` command is used to initialize a Terraform configuration using another module as a skeleton. + The terraform state list command is used to list resources within a Terraform state. --- # Command: state list diff --git a/website/source/docs/commands/state/show.html.md b/website/source/docs/commands/state/show.html.md new file mode 100644 index 0000000000..3ca6e9619c --- /dev/null +++ b/website/source/docs/commands/state/show.html.md @@ -0,0 +1,47 @@ +--- +layout: "commands-state" +page_title: "Command: state show" +sidebar_current: "docs-state-sub-show" +description: |- + The `terraform state show` command is used to show the attributes of a single resource in the Terraform state. +--- + +# Command: state show + +The `terraform state show` command is used to show the attributes of a +single resource in the +[Terraform state](/docs/state/index.html). + +## Usage + +Usage: `terraform state show [options] PATTERN` + +The command will show the attributes of a single resource in the +state file that matches the given pattern. + +The attributes are listed in alphabetical order (with the except of "id" +which is always at the top). They are outputted in a way that is easy +to parse on the command-line. + +This command requires a pattern that points to a single resource in the +state. Patterns are +in [resource addressing format](/docs/commands/state/addressing.html). + +The command-line flags are all optional. The list of available flags are: + +* `-state=path` - Path to the state file. Defaults to "terraform.tfstate". + +## Example: Show a Resource + +The example below shows a resource: + +``` +$ terraform state show module.foo.packet_device.worker[0] +id = 6015bg2b-b8c4-4925-aad2-f0671d5d3b13 +billing_cycle = hourly +created = 2015-12-17T00:06:56Z +facility = ewr1 +hostname = prod-xyz01 +locked = false +... +``` diff --git a/website/source/layouts/commands-state.erb b/website/source/layouts/commands-state.erb index 674cb48346..e182f0d2e7 100644 --- a/website/source/layouts/commands-state.erb +++ b/website/source/layouts/commands-state.erb @@ -20,6 +20,10 @@