Remote state data source - env zero docs

Terraform allows you to utilize the remote state as a data source. This is particularly useful for retrieving dependent information from a parent resource. env zero’s remote state can be used with Terraform Remote State Data Source.

data "terraform_remote_state" "example" {
  backend = "remote"

  config = {
    hostname     = "backend.api.env0.com"
    organization = "[ORGANIZATION_ID]"
    workspaces = {
      name = "[WORKSPACE_NAME]"
    }
  }
}

The WORKSPACE_NAME is unique per organization.

Here’s an example of how its used:

provider "aws" {
  region = "us-west-2"
}

data "terraform_remote_state" "vpc" {
  backend = "remote"

  config = {
    hostname     = "backend.api.env0.com"
    organization = "aaaaaaaa-bbbb-cccc-dddd-8f43fe49db92"
    workspaces = {
      name = "acme-fitness-agent-vpc"
    }
  }
}

output "vpc_id" {
  value = data.terraform_remote_state.vpc.outputs.vpc_id
}

Next steps

Configuring state access control - Restrict which projects can read a given environment’s state.
Working with environment outputs - Share values between environments using env zero’s output system.
Migrating State - Move state between backends or migrate from TFC.