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

equinix_metal_reserved_ip_block（数据源）

使用此数据源可在 Equinix Metal 中查找 IP 地址块。您可以使用 IP 地址或地址块 ID 进行查找。

为了向后兼容，此数据源也可用于预先创建的（管理）IP 块。

有关产品详情和 API 参考资料，请参阅虚拟路由和转发文档。

用法示例

查找域名对应的 IP 地址，然后使用该 IP 地址查找包含该域名的 IP 地址块，并使用该地址块中的 IP 地址运行设备：

data "dns_a_record_set" "www" {
  host = "www.example.com"
}

data "equinix_metal_reserved_ip_block" "www" {
  project_id = local.my_project_id
  address = data.dns_a_record_set.www.addrs[0]
}

resource "equinix_metal_device" "www" {
  project_id = local.my_project_id
  [...]
  ip_address {
    type = "public_ipv4"
    reservation_ids = [data.equinix_metal_reserved_ip_block.www.id]
  }
}

论证参考

以下论点得到支持：

• id - （可选）要查找的 IP 地址块的 UUID。
• project_id - （可选）要查找的块所在的项目的 UUID。
• ip_address - （可选）将返回包含此 IP 地址的块。

-> 注意： 你应该传递 id，或者同时传递 project_id 和 ip_address。

属性参考

该数据源公开的属性与 equinix_metal_reserved_ip_block 资源相同，但存在以下差异：

• type - 为 global_ipv4、public_ipv4、private_ipv4、public_ipv6 或 vrf 之一