Loading

Quipoin Menu

Learn • Practice • Grow

terraform / State Commands
tutorial

State Commands

Terraform provides a set of state management commands to inspect and modify the state file. These are advanced tools, but they can be lifesavers when you need to fix state issues.

Listing Resources in State

terraform state list
This shows all resources currently tracked in the state. Useful to see what Terraform is managing.

Showing Resource Details

Inspect a specific resource:
terraform state show aws_instance.web
This prints the full resource attributes as stored in state.

Moving a Resource

If you rename a resource in your configuration, Terraform would see it as a new resource and try to destroy the old one. Use state mv to tell Terraform that the existing resource now has a new address.
terraform state mv aws_instance.old_name aws_instance.new_name

Removing a Resource from State

If you want Terraform to stop managing a resource (without destroying it), remove it from state:
terraform state rm aws_instance.web
The resource will continue to exist, but Terraform will no longer track it. Use with caution.

Pulling and Pushing State

Download the current state to a local file:
terraform state pull > state.backup
Upload a state file (only in emergency):
terraform state push state.backup

Forcing Unlock

If a state lock is stuck (e.g., after a crash), you can force unlock:
terraform force-unlock LOCK_ID
Be absolutely sure no other operation is running.


Two Minute Drill
  • terraform state list – show all resources in state.
  • terraform state show – view resource details.
  • terraform state mv – rename a resource in state.
  • terraform state rm – stop managing a resource.
  • Use force-unlock only when absolutely necessary.

Need more clarification?

Drop us an email at career@quipoinfotech.com