2016-03-25 18:26:30 +01:00
|
|
|
---
|
|
|
|
layout: "commands-state"
|
|
|
|
page_title: "Command: state show"
|
2018-12-21 03:18:13 +01:00
|
|
|
sidebar_current: "docs-commands-state-sub-show"
|
2016-03-25 18:26:30 +01:00
|
|
|
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
|
|
|
|
|
2016-03-25 22:33:31 +01:00
|
|
|
Usage: `terraform state show [options] ADDRESS`
|
2016-03-25 18:26:30 +01:00
|
|
|
|
|
|
|
The command will show the attributes of a single resource in the
|
2016-03-25 22:33:31 +01:00
|
|
|
state file that matches the given address.
|
2016-03-25 18:26:30 +01:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
2019-03-21 22:05:41 +01:00
|
|
|
This command requires an address that points to a single resource in the
|
2016-03-25 22:33:31 +01:00
|
|
|
state. Addresses are
|
2016-03-25 18:26:30 +01:00
|
|
|
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".
|
2017-03-15 18:20:26 +01:00
|
|
|
Ignored when [remote state](/docs/state/remote.html) is used.
|
2016-03-25 18:26:30 +01:00
|
|
|
|
|
|
|
## 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
|
|
|
|
...
|
|
|
|
```
|