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

equinix_metal_virtual_circuit（リソース）

Equinix Fabric - Software-Defined Interconnectionsの専用ポートにVLANを関連付けるには、このリソースをご利用ください。

製品の詳細と API リファレンス資料については、[Virtual Routing and Forwarding documentation を参照してください。

使用例

locals {
  project_id = "52000fb2-ee46-4673-93a8-de2c2bdba33c"
  conn_id = "73f12f29-3e19-43a0-8e90-ae81580db1e0"
}

data "equinix_metal_connection" test {
  connection_id = local.conn_id
}

resource "equinix_metal_vlan" "test" {
  project_id = local.project_id
  metro      = data.equinix_metal_connection.test.metro
}

resource "equinix_metal_virtual_circuit" "test" {
  connection_id = local.conn_id
  project_id = local.project_id
  port_id = data.equinix_metal_connection.test.ports[0].id
  vlan_id = equinix_metal_vlan.test.id
  nni_vlan = 1056
}

スキーマ

必須

• port_id (String) VC がスコープされる接続ポートの UUID。
• project_id (String) VC がスコープされるプロジェクトの UUID

オプション

• connection_id (String) VC がスコープされる接続の UUID。 専用接続にのみ使用されます。
• customer_ip (String) CSR スイッチがピアリングする顧客 IP アドレス。デフォルトは、サブネット内の他の使用可能な IP です。
• customer_ipv6 (String) CSR スイッチがピアリングする顧客 IPv6 アドレス。デフォルトは、IPv6 サブネット内の他の使用可能な IP です。
• description （文字列） 仮想サーキットリソースの説明
• md5 (String, Sensitive) VRF BGP ピアに設定可能なパスワード。
• metal_ip （文字列） VirtualCircuit の SVI （Switch Virtual Interface） の Metal IP アドレス。デフォルトはサブネットで最初に使用可能な IP です。
• metal_ipv6（文字列） VirtualCircuitのSVI（スイッチ仮想インターフェイス）のメタルIPv6アドレス。デフォルトはIPv6サブネットの最初の使用可能なIPです。
• name （文字列） 仮想サーキットのリソース名
• nni_vlan（番号） Equinix Metalネットワーク間VLAN ID（接続がmode=tunnelの場合はオプション）
• peer_asn （番号） ピアの BGP ASN。同じ ASN を複数の VC で使用することはできますが、VRF の local_asn と同じにすることはできません。
• speed （文字列） 仮想回線速度の説明。これは情報目的で、接続タイプが共有の場合に計算されます。
• subnet (String) IP 予約を作成する VRF の IP ブロックのサブネット。30 または /31 のどちらかのみ。 * 31ブロックの場合、IPアドレスは2つだけで、metal_ipとcustomer_ipに使用されます。 * 30ブロックには4つのIPアドレスがありますが、最初と最後のIPアドレスは使用できません。metal_ipのデフォルトは最初の使用可能なIPアドレスになります。
• subnet_ipv6 (String) IP 予約を作成する VRF に関連する IPv6 ブロックのサブネット。126 または /127 のいずれか一方のみ。 * 127ブロックでは、metal_ipとcustomer_ipに使用される2つのIPアドレスのみを持ちます。 * 126ブロックには4つのIPアドレスがありますが、最初と最後のIPアドレスは使用できません。metal_ipのデフォルトは最初の使用可能なIPアドレスになります。
• tags （文字列のリスト） 仮想回線に付けられたタグ
• virtual_circuit_id (String) 構成する既存の VC の UUID。VCがすでに作成されている共有相互接続の場合に使用します。
• vlan_id (String) 関連付ける VLAN の UUID。
• vrf_id （文字列） 関連付ける VRF の UUID

読み取り専用

• id （文字列） このリソースの ID。
• nni_vnid （番号） Nni VLAN ID パラメーター、https://docs.equinix.com/metal/interconnections/introduction/ 参照。
• status （文字列） 仮想回線リソースのステータス
• vnid （番号） VNID VLANパラメータ、https://docs.equinix.com/metal/interconnections/introduction/ 参照。

インポート

インポートは以下の構文でサポートされています：

terraform import equinix_metal_virtual_circuit {existing_id}