跳至内容

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

equinix_metal_device（数据源）

该数据源可用于获取单个设备的信息。

如果您需要获取符合筛选条件的设备列表，可以使用 equinix_metal_devices 数据源。

~> **注意：**所有参数，包括 root_password 和 user_data，都将以纯文本形式存储在原始状态中。阅读更多关于状态中敏感数据的信息。

用法示例​

# Fetch a device data by hostname and show it's ID

data "equinix_metal_device" "test" {
  project_id = local.project_id
  hostname   = "mydevice"
}

output "id" {
  value = data.equinix_metal_device.test.id
}
# Fetch a device data by ID and show its public IPv4
data "equinix_metal_device" "test" {
  device_id = "4c641195-25e5-4c3c-b2b7-4cd7a42c7b40"
}

output "ipv4" {
  value = data.equinix_metal_device.test.access_public_ipv4
}

模式​

可选​

  • device_id（字符串）设备 ID
  • hostname（字符串）设备名称
  • project_id（字符串）设备所在项目的 ID

只读​

  • access_private_ipv4（字符串）分配给设备的 IPv4 私有 IP 地址
  • access_public_ipv4（字符串）分配给设备的 IPv4 管理 IP 地址
  • access_public_ipv6（字符串）分配给设备的 IPv6 管理 IP 地址
  • always_pxe（布尔值）
  • billing_cycle（字符串）设备的计费周期（按月或按小时）
  • description（字符串）设备的描述字符串
  • facility（字符串，已弃用）设备部署所在的设施
  • hardware_reservation_id（字符串）此设备占用的硬件预留 ID
  • id（字符串）此资源的 ID。
  • ipxe_script_url（字符串）
  • metro（字符串）设备部署所在的地铁。
  • network（对象列表）设备的私有和公共 IP（v4 和 v6）网络详细信息。当设备在没有任何特殊网络配置的情况下运行时，它将有 3 个网络：位于 equinix_metal_device.name.network.0 的公共 IPv4 网络、位于 equinix_metal_device.name.network.1 的 IPv6 网络和位于 equinix_metal_device.name.network.2 的私有 IPv4 网络。弹性地址按类型堆叠——分配的公共 IPv4 地址将位于管理公共 IPv4 地址之后（索引为 1），然后移动 IPv6 和私有 IPv4 地址的索引。分配的私有 IPv4 地址将位于管理私有 IPv4 地址之后（位于网络列表的末尾）。（有关嵌套模式，请参见下文）
  • network_type（字符串）设备的 L2 网络类型，取值范围为 layer3、hybrid、layer2-individual 或 layer2-bonded。
  • operating_system（字符串）设备上运行的操作系统
  • plan（字符串）设备的硬件配置
  • ports（对象列表）分配给设备的端口（有关嵌套架构，请参见下面的嵌套架构）
  • root_password（字符串，敏感信息）服务器的 root 密码（如果仍然可用）
  • sos_hostname（字符串）用于通过 SSH 串口访问设备的主机名（https://docs.equinix.com/metal/resilience-recovery/serial-over-ssh/）。
  • ssh_key_ids（字符串列表）设备中部署的 SSH 密钥 ID 列表，可以是用户 SSH 密钥，也可以是项目 SSH 密钥。
  • state（字符串）设备状态
  • storage（字符串）
  • tags（字符串列表）附加到设备的标签

network 的嵌套模式​

只读：

  • address（字符串）
  • cidr（数字）
  • family（数字）
  • gateway（字符串）
  • public（布尔值）

ports 的嵌套模式​

只读：

  • bonded（布尔值）
  • id（字符串）
  • mac（字符串）
  • name（字符串）
  • type（字符串）
此页面有帮助吗？