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

equinix_metal_port（资源）

使用此资源配置 Equinix Metal 设备上的网络端口。此资源可以控制物理端口和绑定端口。

此 Terraform 资源不会在 Equinix Metal 中创建 API 资源，而是为 [Layer 2 networking 提供更精细的控制。

所引用的端口资源与设备一起创建，可通过设备资源或通过 /port/<uuid> API 路径访问。

要实现门户中提供的网络配置，可能需要创建和组合各种 equinix_metal_port 资源。有关此类资源的示例，请参阅网络类型指南。

论证参考

以下论点得到支持：

• port_id - （必填）要读取的端口的 ID。
• bonded - （必填）端口是否应绑定。
• layer2 - （可选）是否将端口置于第 2 层模式，仅对绑定端口有效。
• vlan_ids - （可选）要附加到端口的 VLAN UUID 列表，仅对 L2 和混合端口有效。
• vxlan_ids - （可选）要附加到端口的 VXLAN ID 列表，仅对 L2 和混合端口有效。
• native_vlan_id - （可选）要分配为本机 VLAN 的 VLAN 的 UUID。它必须是已附加 VLAN 之一（来自 vlan_ids 参数）。
• reset_on_delete - （可选）行为设置，用于在删除/销毁之前将端口重置为默认设置（第 3 层绑定模式，未附加任何 VLAN）。

暂停

timeouts 代码块允许您为某些操作指定 超时：

这些超时时间包括解除绑定、转换为 L2/L3、绑定和更新本地 vLAN 的时间。

• create - （默认为 30 分钟）创建端口时使用。
• update - （默认为 30 分钟）用于更新端口时。
• delete - （默认为 30 分钟）用于删除端口时。

属性参考

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

• name - 端口名称，例如 bond0 或 eth0。
• network_type - 可以是 layer2-bonded、layer2-individual、layer3、hybrid 或 hybrid-bonded 之一。此属性仅在绑定端口上设置。
• type - 类型为“NetworkBondPort”（绑定端口）或“NetworkPort”（可绑定以太网端口）。
• mac - 端口的 MAC 地址。
• bond_id - 绑定端口的 UUID。
• bond_name - 绑定端口的名称。
• disbond_supported - 指示端口是否可以从绑定中移除的标志。