リソース参照の構文

AWSなどのクラウドサービスでインフラを構築する際、リソース同士は独立しているわけではなく、関係性を持っています。例えば、「作成したVPCの中に、サブネットを作りたい」という場合です。この時、サブネット側では「どのVPCに所属するか」を指定する必要があります。

1. 参照の構文

リソースの値(属性)を参照するには、以下の構文を使用します。

リソースの型.リソース名.属性

例えば、aws_vpc というリソース型で、vpc という名前で定義したVPCの、ID(id)を参照したい場合は、以下のように記述します。

aws_vpc.vpc.id

各リソースで参照できる属性(id 以外にも arn や cidr_block など)は、リソースごとにTerraform Registryのドキュメント(例:aws_vpc)の「Attribute Reference」セクションにまとめられています。

2. サンプル

実際に値を参照するサンプルを説明します。

今回は、VPCとサブネットを作り、サブネットに指定するVPCのIDに、作成したVPCのIDを設定する方法を紹介します。

まず、VPCは通常通りのコードで構いません。

resource "aws_vpc" "vpc" {
  cidr_block = "10.0.0.0/16"
  tags = {
    Name = "test-vpc"
  }
}

サブネットの定義部分です。

resource "aws_subnet" "subnet" {
  vpc_id     = aws_vpc.vpc.id

  cidr_block = "10.0.1.0/24"
  tags = {
    Name = "test-subnet"
  }
}

この中で、vpc_id = aws_vpc.vpc.id の部分がポイントです。

こうすることで、サブネットに指定されるVPCのIDは、直前の vpc のIDとなります。

⚠️ 「has not been declared」エラーが出る場合
aws_vpc.vpc.id の部分で、リソース名(2つ目の vpc)を間違えると「A managed resource "aws_vpc" "xxx" has not been declared」というエラーが発生します。エラーが出たら、リソース定義の名前(resource "aws_vpc" "vpc" の "vpc" 部分)と参照先が一致しているか確認してください。

3. 実行順序の自動制御

リソース間の参照による依存関係と作成順序の例を以下に示します。

この記述の重要な点は、Terraformがリソースを作成する順番を自動的に判断してくれることです。

aws_subnet を作るためには、vpc_id が必要です。

vpc_id を知るためには、先に aws_vpc が作られている必要があります。

Terraformはこの関係性をコードから読み取り、「まずはVPCを作成し、その完了後にサブネットを作成する」という正しい順序で処理を実行します。