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

equinix_metal_ssh_key（资源）

提供用于管理 Equinix Metal 用户帐户上的用户 SSH 密钥的资源。如果您在项目中创建新设备，则该项目所有协作者的密钥都将注入到该设备中。

用户 SSH 密钥与设备之间的关联是隐式的。如果您想确保密钥被复制到设备，则必须确保设备资源 depends_on 和密钥资源相同。

用法示例

# Create a new SSH key
resource "equinix_metal_ssh_key" "key1" {
  name       = "terraform-1"
  public_key = file("/home/terraform/.ssh/id_rsa.pub")
}

# Create new device with "key1" included. The device resource "depends_on" the
# key, in order to make sure the key is created before the device.
resource "equinix_metal_device" "test" {
  hostname         = "test-device"
  plan             = "c3.small.x86"
  metro            = "sv"
  operating_system = "ubuntu_24_04"
  billing_cycle    = "hourly"
  project_id       = local.project_id
  depends_on       = ["equinix_metal_ssh_key.key1"]
}

论证参考

以下论点得到支持：

• name - （必填）用于标识的 SSH 密钥名称
• public_key - （必填）公钥。如果这是一个文件，则可以使用文件插值函数读取它。

属性参考

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

• id - 密钥的唯一 ID。
• name - SSH 密钥的名称。
• public_key - 公钥文本。
• fingerprint - SSH密钥的指纹。
• owner_id - 拥有此密钥的 Equinix Metal API 用户的 UUID。
• created - SSH 密钥创建时的时间戳。
• updated - SSH 密钥上次更新的时间戳。

进口

可以使用现有的 SSH 密钥 ID 导入此资源：

terraform import equinix_metal_ssh_key {existing_sshkey_id}