terraform/r/remote_state.html.md

layout	page_title	sidebar_current	description
terraform	Terraform: terraform_remote_state	docs-terraform-resource-remote-state	Accesses state meta data from a remote backend.

remote_state

Retrieves state meta data from a remote backend

Example Usage

resource "terraform_remote_state" "vpc" {
    backend = "atlas"
    config {
        path = "hashicorp/vpc-prod"
    }
}

resource "aws_instance" "foo" {
    # ...
    subnet_id = "${terraform_remote_state.vpc.output.subnet_id}"
}

Argument Reference

The following arguments are supported:

• backend - (Required) The remote backend to use.
• config - (Optional) The configuration of the remote backend.

Attributes Reference

The following attributes are exported:

• backend - See Argument Reference above.
• config - See Argument Reference above.
• output - The values of the configured outputs for the root module referenced by the remote state.