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

equinix_metal_ip_attachment（资源）

提供将弹性 IP 子网附加到设备的资源。

要将保留块中的 IP 子网附加到已配置的设备，您必须从与目标设备位于同一项目和城域中的某个保留块中派生出子网 CIDR。

例如，如果您已预留 IPv4 地址块 147.229.10.152/30，您可以选择将整个地址块作为一个子网分配给一个设备；或者分配为两个子网，CIDR 分别为 147.229.10.152/31 和 147.229.10.154/31；或者分配为四个子网，掩码前缀长度为 32。有关弹性 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 表示法分配的子网，例如 147.229.15.30/31
• gateway - 子网网关的 IP 地址。
• network - 子网网络地址。
• netmask - 子网掩码（十进制表示），例如 255.255.255.0。
• cidr - 子网 CIDR 前缀的长度（整数）。
• address_family - 地址族，以整数形式表示。取值为 4 或 6。
• public - 布尔标志，表示子网是否可从 Internet 访问。