2017-02-15 22:14:32 +01:00
|
|
|
---
|
|
|
|
layout: "commands-state"
|
|
|
|
page_title: "Command: state pull"
|
2018-12-21 03:18:13 +01:00
|
|
|
sidebar_current: "docs-commands-state-sub-pull"
|
2017-02-15 22:14:32 +01:00
|
|
|
description: |-
|
|
|
|
The `terraform state pull` command is used to manually download and output the state from remote state.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Command: state pull
|
|
|
|
|
|
|
|
The `terraform state pull` command is used to manually download and output
|
|
|
|
the state from [remote state](/docs/state/remote.html). This command also
|
|
|
|
works with local state.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
Usage: `terraform state pull`
|
|
|
|
|
|
|
|
This command will download the state from its current location and
|
|
|
|
output the raw format to stdout.
|
|
|
|
|
|
|
|
This is useful for reading values out of state (potentially pairing this
|
|
|
|
command with something like [jq](https://stedolan.github.io/jq/)). It is
|
|
|
|
also useful if you need to make manual modifications to state.
|