terraform/website/docs/cli/commands/state/pull.html.md

1.0 KiB

layout page_title sidebar_current description
docs Command: state pull docs-commands-state-sub-pull 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. This command also works with local state.

Usage

Usage: terraform state pull

This command will download the state from its current location, upgrade the local copy to the latest state file version that is compatible with locally-installed Terraform, and output the raw format to stdout.

This is useful for reading values out of state (potentially pairing this command with something like jq). It is also useful if you need to make manual modifications to state.

~> Note: This command cannot be used to inspect the Terraform version of the remote state, as it will always be converted to the current Terraform version before output.