~> 弃用通知 Equinix Metal 将于2026年6月30日停止服务。所有 Metal 数据源将在该提供商的 5.0.0 版本中移除。如需继续使用，请使用该提供商的 4.x 版本直至服务终止。更多信息，请访问 https://docs.equinix.com/metal/。

equinix_metal_vlan（数据源）

提供 Equinix Metal 虚拟网络数据源。VLAN 数据源可通过 VLAN UUID 或项目 UUID 和 VXLAN 编号进行搜索。

用法示例

通过 ID 获取 VLAN：

resource "equinix_metal_vlan" "foovlan" {
  project_id = local.project_id
  metro = "sv"
  vxlan = 5
}

data "equinix_metal_vlan" "dsvlan" {
  vlan_id = equinix_metal_vlan.foovlan.id
}

通过项目 ID、VXLAN 和城域网获取 VLAN

data "equinix_metal_vlan" "dsvlan" {
  project_id = local.project_id
  vxlan      = 5
  metro      = "sv"
}

论证参考

以下论点得到支持：

• vlan_id - （可选）要查找的 VLAN 资源的 Metal UUID。
• project_id - （可选）VLAN 父项目的 UUID。与 vxlan 编号和城域网或设施一起使用。
• vxlan - （可选）要查找的 VLAN 的 VXLAN 编号。与 project_id 和 metro 或 facility 一起使用。
• facility - （可选）VLAN 部署所在的设施。已弃用，请参阅 https://docs.equinix.com/metal/locations/facilities/
• metro - （可选）VLAN 部署所在的城域网。

-> 注意： 您必须设置 vlan_id 或 vxlan、project_id 和 metro 或 facility 的组合。

属性参考

除了上述所有参数外，还会导出以下属性：

• description - VLAN 资源的描述文本。
• assigned_devices_ids - 分配给此 VLAN 的设备 ID 列表。