~>非推奨のお知らせ Equinix Metalは、2026年6月30日 でサポートを終了します。すべてのMetalリソースは、このプロバイダのバージョン5.0.0で削除されます。廃止までの継続利用には、このプロバイダのバージョン4.xをご利用ください。詳細は https://docs.equinix.com/metal/ をご覧ください。

equinix_metal_ip_attachment（リソース）

エラスティックIPサブネットをデバイスにアタッチするためのリソースを提供します。

予約済みブロックからプロビジョニングされたデバイスにIPサブネットをアタッチするには、ターゲットデバイスと同じプロジェクトおよびメトロ内の予約済みブロックの1つに属するサブネットCIDRを導出する必要があります。

例えば、IPv4アドレスブロック147.229.10.152/30を予約した場合、ブロック全体を1つのサブネットとしてデバイスに割り当てるか、CIDR147.229.10.152/31と147.229.10.154/31で2つのサブネットを割り当てるか、マスクプレフィックス長32で4つのサブネットを割り当てるかを選択できます。エラスティック IP サブネットの詳細は こちら を参照してください。

デバイスと予約ブロックは同じメトロにある必要があります。

使用例

# Reserve /30 block of max 2 public IPv4 addresses in metro ny for myproject
resource "equinix_metal_reserved_ip_block" "myblock" {
  project_id = local.project_id
  metro      = "ny"
  quantity   = 2
}

# Assign /32 subnet (single address) from reserved block to a device
resource "equinix_metal_ip_attachment" "first_address_assignment" {
  device_id = equinix_metal_device.mydevice.id
  # following expression will result to sth like "147.229.10.152/32"
  cidr_notation = join("/", [cidrhost(metal_reserved_ip_block.myblock.cidr_notation, 0), "32"])
}

引数リファレンス

以下の引数をサポートしています：

• device_id - （必須）サブネットを割り当てるデバイスの ID。
• cidr_notation - （必須）デバイスと同じプロジェクトおよびメトロで予約されたブロックのサブネットの CIDR 表記。

属性リファレンス

上記のすべての引数に加えて、以下の属性がエクスポートされます：

• id - 割り当ての一意の ID。
• device_id - サブネットが割り当てられているデバイスの ID。
• cidr_notation - CIDR表記で割り当てられたサブネット。
• gateway - サブネットのゲートウェイの IP アドレス。
• network - サブネットのネットワークアドレスです。
• netmask - 10進数表記のサブネットマスク。
• cidr - サブネットの CIDR プレフィックスの長さ（整数）。
• address_family - 整数としてのアドレスファミリ。4または6のいずれか。
• public - サブネットがインターネットから到達可能かどうかのブール値フラグ。