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

equinix_metal_precreated_ip_block（数据源）

使用此数据源可获取 Equinix Metal 中预先创建的（管理）IPv6 和 IPv4 地址块的 CIDR 表达式。然后，您可以使用内置的 cidrsubnet TF 函数来派生子网。

~> 为了向后兼容，此数据源还将返回保留的（弹性）IP 块。

-> 预先创建的（管理）IP 块只有在该都市圈创建了第一个设备后才能使用。

-> 无法检索自动分配给设备（管理）的公共 IPv4 地址块。如果您需要此信息，请考虑改用 equinix_metal_device 数据源。

用法示例

# Create device in your project and then assign /64 subnet from precreated block
# to the new device

# Declare your project ID
locals {
  project_id = "<UUID_of_your_project>"
}

resource "equinix_metal_device" "web1" {
  hostname         = "web1"
  plan             = "c3.small.x86"
  metro            = "sv"
  operating_system = "ubuntu_24_04"
  billing_cycle    = "hourly"
  project_id       = local.project_id

}

data "equinix_metal_precreated_ip_block" "test" {
  metro          = "sv"
  project_id     = local.project_id
  address_family = 6
  public         = true
}

# The precreated IPv6 blocks are /56, so to get /64, we specify 8 more bits for network.
# The cirdsubnet interpolation will pick second /64 subnet from the precreated block.

resource "equinix_metal_ip_attachment" "from_ipv6_block" {
  device_id     = equinix_metal_device.web1.id
  cidr_notation = cidrsubnet(data.equinix_metal_precreated_ip_block.test.cidr_notation, 8, 2)
}

论证参考

以下论点得到支持：

• project_id - （必填）要查找的块所在的项目 ID。
• address_family - （必填）4 或 6，具体取决于您要查找的块。
• public - （必填）是否查找公共区块或私有区块。
• global - （可选）是否查找全局代码块。默认值为 false，以保持向后兼容性。
• facility - （已弃用）搜索块的 Facility。（适用于非全局块）。请改用 metro；请阅读Facility 到 metro 迁移指南
• metro - （可选）搜索块的 Metro（对于非全局块）。

属性参考

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

• cidr_notation - 查找块的 CIDR 表示法。