github.com/adrian-bl/terraform@v0.7.0-rc2.0.20160705220747-de0a34fc3517/website/source/docs/providers/terraform/d/remote_state.html.md (about)

     1  ---
     2  layout: "terraform"
     3  page_title: "Terraform: terraform_remote_state"
     4  sidebar_current: "docs-terraform-datasource-remote-state"
     5  description: |-
     6    Accesses state meta data from a remote backend.
     7  ---
     8  
     9  # remote\_state
    10  
    11  Retrieves state meta data from a remote backend
    12  
    13  ## Example Usage
    14  
    15  ```
    16  data "terraform_remote_state" "vpc" {
    17      backend = "atlas"
    18      config {
    19          name = "hashicorp/vpc-prod"
    20      }
    21  }
    22  
    23  resource "aws_instance" "foo" {
    24      # ...
    25      subnet_id = "${data.terraform_remote_state.vpc.output.subnet_id}"
    26  }
    27  ```
    28  
    29  ## Argument Reference
    30  
    31  The following arguments are supported:
    32  
    33  * `backend` - (Required) The remote backend to use.
    34  * `config` - (Optional) The configuration of the remote backend.
    35   * Remote state config docs can be found [here](https://www.terraform.io/docs/state/remote/atlas.html)
    36  
    37  ## Attributes Reference
    38  
    39  The following attributes are exported:
    40  
    41  * `backend` - See Argument Reference above.
    42  * `config` - See Argument Reference above.
    43  * `output` - The values of the configured `outputs` for the root module referenced by the remote state.