IBM Cloud Docs
管理 Bare Metal Servers for VPC

管理 Bare Metal Servers for VPC

您可以通过执行启动、停止、更新固件、重启、重新初始化和删除裸机服务器等任务来管理 IBM Cloud® Bare Metal Servers for VPC。

您可以使用 UI,CLI 和 API 执行以下操作。

裸机服务器可采取的行动
操作 描述
停止
  • 软停止关闭服务器可能需要几秒到几分钟的时间,具体取决于操作系统的状态。
  • 硬停止会立即关闭裸机服务器。 这种方法会阻止操作系统优雅地关闭。
Start 启动已停止的服务器。 如果状态为“正在运行”,那么此操作不可用。
更新固件 如果服务器已停止并且固件更新可用,那么此选项可视。

如果选择更新固件,系统将显示提示,提供有关固件更新的更多详细信息。 更新完成后即可启动服务器。 缺省情况下,已选中该选项。

您可以选择继续固件更新或取消固件更新。
重要信息 建议在任何固件更新之前备份服务器。

重新引导 立即关闭正在运行的服务器的电源,然后将其重新打开。
重新初始化 只有当服务器停止时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。
删除(T) 要删除服务器,必须关闭服务器电源。 如果服务器具有浮动 IP 地址,那么必须先取消关联或释放浮动 IP 地址,然后才能删除服务器。 删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

要管理裸机服务器,需要一个包含以下操作的 IAM 角色。 有关更多信息,请参阅 管理 VPC 基础架构服务的 IAM 访问权

  • is.bare-metal-server.bare-metal-server.list
  • is.bare-metal-server.bare-metal-server.read
  • is.bare-metal-server.bare-metal-server.delete
  • is.bare-metal-server.bare-metal-server.update
  • is.bare-metal-server.bare-metal-server.operate
  • is.key.key.operate
  • is.image.image.operate
  • is.bare-metal-server.bare-metal-server-firmware.update(更新固件时需要)
  • is.bare-metal-server.initialization.update(需要重新初始化服务器)

使用 UI 管理裸机服务器

您可以通过 IBM Cloud 控制台中的 Bare metal servers 页面查看和管理裸机服务器。

要管理服务器,请完成以下步骤。

  1. IBM Cloud 仪表盘,转到 导航菜单 图标菜单图标 > 基础设施 VPC 图标 > 计算 > 裸机服务器
  2. 在“裸机服务器”页面上,单击要管理的服务器的“操作”图标 "更多操作" 图标。 您可以执行以下操作:

使用 UI 查看裸机服务器

您可以在裸机服务器页面上查看所有裸机服务器的摘要,也可以单击单个服务器名称以查看详细信息并进行更改。 在详细信息页面中,您还可以查看关联的网络接口,访问其子网,更改 Sapphire Rapids 服务器上的网络带宽,以及保留或删除浮动 IP 地址。

Sapphire Rapids 裸机服务器的可调网络带宽仅在美国南部 (达拉斯) 可用。

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要查看的裸机服务器名称。

使用 UI 更新裸机服务器的固件

仅当服务器已停止并且固件更新可用时,才会显示此操作。 建议在更新固件前备份服务器。

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器

  2. 单击要重启的裸机服务器名称。

  3. 单击 操作 ...,然后单击 更新固件

    选择更新固件时,您将收到以下消息。

    此选项可更新服务器上的 BIOS 和 BMC 固件。 请先备份服务器,然后继续。 在此过程中,服务器将停止运行,无法使用。

    默认选择更新完成后启动服务器。 如果您不希望服务器重新启动,请除去该检查。

  4. 单击 继续 以启动固件更新。 单击“**取消 **”取消更新。

使用 UI 重新引导裸机服务器

重新引导操作将立即关闭并打开裸机服务器的电源。

  1. IBM Cloud 仪表盘 外部链接图标、转到 导航菜单 图标 菜单图标 基础设施 VPC 图标 计算 > 裸机服务器
  2. 单击要重启的裸机服务器名称。
  3. 单击 操作 ...,然后单击 重新引导

使用 UI 停止和启动裸机服务器

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要启动或停止的裸机服务器的名称。
  3. 单击 操作 ...,然后单击 停止启动。 选择 Stop 时,请选择硬停止或软停止。 默认情况下,实例会软启动。

在裸机服务器停止后继续计费。

使用用户界面重新初始化裸机服务器

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器

  2. 单击要重新初始化的裸机服务器名称。

  3. 单击 操作...,然后单击 重新初始化

使用 UI 删除裸机服务器

  1. IBM Cloud 控制台,转到 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要删除的裸机服务器名称。
  3. 单击 操作 ...,然后单击 删除

删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

在控制台中添加 CSPM

选择该选项后,将创建一个工作负载保护裸机服务器,并配置为所有资源提供 CSPM。 如果已存在工作负载保护裸机服务器,则无法使用此选项。 更多信息,请参阅 关于 IBM Cloud Security Posture Management(CSPM)

  1. IBM Cloud 控制台中,转到导航菜单图标菜单图标 > 基础架构 VPC 图标 > 计算 > 裸机服务器
  2. 单击要添加 CSPM 的裸机服务器名称。
  3. 在详细信息页面,转到“集成”选项卡。
  4. 云安全态势管理中,单击添加 CSPM
  5. 添加云安全态势管理 (CSPM) 上,单击创建

此设置可将 CSPM 添加到您账户的现有工作负载保护实例中。 如需了解更多信息,请参阅 实施 CSPM(Cloud Security Posture Management)for IBM Cloud

使用 CLI 管理裸机服务器

使用 CLI 查看裸机服务器

要使用 CLI 列出所有裸机服务器,请使用 ibmcloud is bare-metal-servers 命令。 要检索特定裸机服务器,请使用 SERVER 变量指定裸机服务器的标识或名称。

ibmcloud is bare-metal-server SERVER

有关命令选项的完整列表,请参阅 ibmcloud is 裸机-server

使用 CLI 重新引导裸机服务器

要使用 CLI 重启裸机服务器,请使用 ibmcloud is bare-metal-server-restart 命令。 使用 SERVER 变量指定裸机服务器的标识或名称。

ibmcloud is bare-metal-server-restart SERVER

[-f, --force] 标志强制操作而不确认。

使用 CLI 停止和启动裸机服务器

要使用 CLI 停止和启动裸机服务器,请使用 ibmcloud is bare-metal-server-stopibmcloud is bare-metal-server-start 命令。 使用 SERVER 变量指定裸机服务器的标识或名称。

必须为数据有效内容中的停止操作指定 typesoft 指示正在运行的操作系统停止并完全关闭。hard 立即停止裸机服务器。

要停止裸机服务器,请使用以下命令。

ibmcloud is bare-metal-server-stop SERVER --type soft

要启动裸机服务器,请使用以下命令。

ibmcloud is bare-metal-server-start SERVER

裸机服务器停止运行后,计费仍将继续。

有关命令选项的完整列表,请参见 ibmcloud is bare-metal-server-restart

使用 CLI 更新裸机服务器

要使用 CLI 更新裸机服务器,请使用 ibmcloud is bare-metal-server-update 命令。

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • NAME 受信任配置文件的 ID、名称或 CRN
  • METADATA 指定 或 可启用或禁用元数据服务 true false
  • PROTOCOL 指定元数据服务的协议。
ibmcloud is bare-metal-server-update SERVER --name NAME --enable-secure-boot true --metadata-service true --metadata-service-protocol https

有关命令选项的完整列表,请参见 ibmcloud is bare-metal-server-update

使用 CLI 重新初始化裸机服务器

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

要使用 CLI 重新初始化裸机服务器,请使用 ibmcloud is bare-metal-server-initialization-replace 命令。

ibmcloud is bare-metal-server-initialization-replace SERVER --image IMAGE ---keys KEYS --user-data DATA [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true]]

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • IMAGE 指定操作系统映像
  • KEYS 指定 SSH 密钥
  • DATA 指定任何可选的用户数据
  • PROFILE 受信任配置文件的 ID、名称或 CRN
  • DEFAULT_TRUSTED_PROFILE 更改默认的受信任配置文件自动链接参数

当使用默认受信任配置文件时,重新初始化裸机服务器会包含为默认受信任配置文件定义的相同自动链接参数,以确定是否将受信任配置文件链接到裸机服务器,作为重新初始化过程的一部分。 在重新初始化过程之前与裸机服务器链接的受信任配置文件仍保持链接。 重新初始化过程不会删除与 IAM 受信任配置文件的链接。 要防止受信任配置文件与裸机服务器保持链接,请将 "auto_link "参数改为 false。

有关命令选项的完整列表,请参阅 ibmcloud is bare-metal-server-initialization-replace

使用 CLI 更新裸机服务器的固件

您可以使用命令行界面 (CLI) 更新裸机服务器的固件。 您只能在已停止运行且固件更新可用的裸机服务器上更新固件。 建议在更新固件前备份服务器。

要使用 CLI 更新裸机服务器的固件,请使用 ibmcloud is bare-metal-server-firmware-update 命令。 使用 SERVER 变量指定裸机服务器的 ID 或名称。

auto-start 的默认值是 true。 如果您不希望裸机服务器在更新固件后启动,那么必须将此值更改为 false

ibmcloud is bare-metal-server-firmware-update SERVER --auto-start true

发出该命令后,您将收到一条信息,以确认是否继续进行固件更新。

此选项可升级服务器上的 BIOS 和 BMC 固件。 请先备份服务器,然后再继续。 在此过程中,服务器不可用。 继续 (y/n)?

有关命令选项的完整列表,请参阅 ibmcloud is 裸机-server-firmware-update

使用 CLI 删除裸机服务器

要使用 CLI 删除裸机服务器,请使用 ibmcloud is bare-metal-server-delete 命令。 使用 SERVER 变量指定裸机服务器的 ID 或名称。

ibmcloud is bare-metal-server-delete SERVER

删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

有关命令选项的完整列表,请参阅 ibmcloud is 裸机-server-delete

使用 API 管理裸机服务器

使用 API 查看裸机服务器

要使用 API 列出所有裸机服务器,请使用 列出所有裸机服务器

指定 GET /bare_metal_servers 请求以列出所有裸机服务器。

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

使用应用程序接口检索裸机服务器

要使用 API 检索裸机服务器,请使用 检索裸机服务器

指定一个 GET /bare_metal_servers/{id} 请求,检索特定的裸机服务器,其中 id 是您要检索的裸机服务器的标识符。

curl -X GET "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

有关 API 请求的更多信息,请参阅 列出所有裸机服务器检索裸机服务器

使用 API 重新引导裸机服务器

要使用 API 重启裸机服务器,请使用 重启裸机服务器

指定一个 POST /bare_metal_servers/{id}/restart 请求,以重新启动特定的裸机服务器,其中 id 是您要重新启动的裸机服务器的标识符。

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/restart?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

有关 API 请求的更多信息,请参阅 重新启动裸机服务器

使用 API 停止和启动裸机服务器

要使用 API 停止或启动裸机服务器,请使用 Stop a bare metal serverStart a bare metal server

使用以下 API 请求来停止或启动裸机服务器。

使用 API 停止裸机服务器

指定一个 POST /bare_metal_servers/{id}/stop 请求来停止特定的裸机服务器,其中 id 是您要停止的裸机服务器的标识符。

必须为数据有效内容中的停止操作指定 typesoft 指示正在运行的操作系统停止并完全关闭。hard 立即停止裸机服务器。

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/stop?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"
-d '{
        "type": "soft"
}'

在裸机服务器停止后继续计费。

有关 API 请求的更多信息,请参阅 停止裸机服务器

使用 API 启动裸机服务器

指定一个 POST /bare_metal_servers/{id}/start 请求,启动一台特定的裸机服务器,其中 id 是您要启动的裸机服务器的标识符。

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/start?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

有关 API 请求的更多信息,请参阅 启动裸机服务器

使用应用程序接口更新裸机服务器

指定 PATCH /bare_metal_servers/{id} 请求更新特定裸机服务器,其中 id 是要更新的裸机服务器的标识符。

curl -X PATCH "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2025-05-13&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "name": "my-bare-metal-server-updated"
  "metadata_service": {
     "enabled": true,
     "protocol": "https"
  }
}'

指定更新裸机服务器时要使用的以下属性值。

  • name 指定裸机服务器的名称
  • metadata_service 指定服务是否启用以及使用哪种协议。

有关 API 请求的更多信息,请参阅 更新裸机服务器

使用应用程序接口重新初始化裸机服务器

要使用 API 重新初始化裸机服务器,请使用 裸机服务器初始化

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

指定 PUT /bare_metal_servers/{id}/initialization 请求以重新初始化裸机服务器。

curl -X PUT "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/initialization?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token" \
-d '{
	  "image": {
		"id": $image
	  },
	  "keys": [
		{
			"id": $key
		}
	  ],
	  "default_trusted_profile": {
		"auto_link": true,
		"target": {
			"id": $trusted_profile
		}
	  }
}'

指定重新初始化裸机服务器时要使用的以下属性值。

  • name 指定裸机服务器的名称
  • image 指定操作系统映像
  • keys 指定 SSH 密钥
  • user_data 指定任何可选的用户数据
  • default_trusted_profile 更改或删除默认的受信任配置文件

当使用 default_trusted_profile 时,重新初始化裸机服务器包括为 default_trusted_profile 定义的相同 "auto_link" 参数,以确定是否将可信配置文件链接到裸机服务器,作为重新初始化过程的一部分。 在重新初始化过程之前与裸机服务器链接的受信任配置文件仍保持链接。 重新初始化过程不会删除与 IAM 受信任配置文件的链接。 要防止受信任配置文件与裸机服务器保持链接,请将 "auto_link" 参数更改为 false

使用 API 更新裸机服务器的固件

您只能在已停止运行且固件更新可用的裸机服务器上更新固件。 建议在更新固件前备份服务器。 要使用 API 更新固件,请使用 为裸机服务器更新固件

指定一个 POST /bare_metal_servers/{id}/firmware/update 请求,以更新特定裸机服务器的固件,其中 id 是您要更新的裸机服务器的标识符。

auto_start 的默认值是 true。 如果不想在固件更新后启动裸机服务器,则必须将此值更改为 false

curl -X POST "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id/firmware/update?version=$tomorrow&generation=2&maturity=beta" -H "Authorization: Bearer $iam_token" -d '{
  "auto_start": false
}'

使用 API 删除裸机服务器

要使用 API 删除裸机服务器,请使用 Delete a bare metal server

指定一个 DELETE /bare_metal_servers/{id} 请求,删除一个特定的裸机服务器,其中 id 是您要删除的裸机服务器的标识符。

curl -X DELETE "$vpc_api_endpoint/v1/bare_metal_servers/$bare_metal_server_id?version=2021-03-09&generation=2" \
-H "Authorization: $iam_token"

删除操作可从账户中永久删除服务器及其连接的 vNIC, 启动卷和数据。

使用 Terraform 管理裸机服务器

确保设置了 Terraform for VPC

使用 Terraform 查看裸机服务器

要使用 Terraform 查看裸机服务器,请使用 ibm_is_bare_metal_server 资源。

data "ibm_is_bare_metal_server" "example" {
  identifier        = "9328-9849-9849-9849"
}

有关详细信息,请参阅 ibm_is_bare_metal_server

要查看所有裸机服务器的列表,请使用 ibm_is_bare_metal_servers 资源。

data "ibm_is_bare_metal_servers" "example" {
}

有关详细信息,请参阅 ibm_is_bare_metal_servers

使用 Terraform 重启裸机服务器

要使用 Terraform 重启裸机服务器,需要使用 ibm_is_bare_metal_server_action 资源。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "restart"
}

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • restart 指定服务器的操作

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server_action

使用 Terraform 停止和启动裸机服务器

要使用 Terraform 停止裸机服务器,需要使用 ibm_is_bare_metal_server_action 资源。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  stop_type         = "hard"
}

要使用 Terraform 启动裸机服务器,需要使用 ibm_is_bare_metal_server_action 资源。

resource "ibm_is_bare_metal_server_action" "bms_action" {
  bare_metal_server = SERVER
  action            = "stop"
  delete_type       = "hard"
}

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • stopstart 指定服务器的操作
  • hard 专用于停止服务器,表示停止类型。 指定 hard 会立即停止服务器,而 soft 则会关闭操作系统。

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server_action

使用 Terraform 重新初始化裸机服务器

只有当服务器已停止并已配置本地存储时,才能重新初始化服务器。 或者,如果服务器状态为 failed,且生命周期状态的状态原因为 cannot_reinitialize,则可以重新初始化。 当重新初始化裸机服务器时,会擦除启动盘的内容并安装指定的操作系统。 服务器保留相同的物理节点、接口、IP 地址和资源 ID。 保留辅助硬盘上的数据。

要使用 Terraform 重新初始化裸机服务器,需要使用资源命令 ibm_is_bare_metal_server_initialization

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
  default_trusted_profile {
      auto_link = true
      target {
          id = "Profile-a2075c9d-c69f-404f-8488-7962a383059c"
      }
  }
}

指定以下变量,以便在重新初始化裸机服务器时使用。

  • SERVER 指定裸机服务器的名称
  • DATA 指定任何可选的用户数据
  • KEYS 指定 SSH 密钥
  • IMAGE 指定操作系统映像
  • Default Trusted Profile 如果启用自动链接,则指定

虽然可以保留相同的物理节点、接口、IP 地址和资源 ID,但也可以选择使用 lifecycle 属性来避免这些更改。

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server_initialization

resource "ibm_is_bare_metal_server_initialization" "reinitialize" {
  bare_metal_server = SERVER
  user_data         = DATA
  keys              = KEYS
  image             = "IMAGE"
}
## to avoid changes on the ibm_is_bare_metal_server resource, use lifecycle meta argument ignore_changes
resource "ibm_is_bare_metal_server" "bms" {
  ....
  lifecycle{
    ignore_changes = [ image, keys, user_data ]
  }
}

使用 Terraform 删除裸机服务器

要使用 Terraform 删除裸机服务器资源,需要使用 ibm_is_bare_metal_server 资源。

resource "ibm_is_bare_metal" "server" {
  delete_type          = "hard"
}

指定删除裸机服务器时要使用的以下变量。

  • hard 指定 hard 删除,立即停止并删除服务器。 另一个选项是 soft 删除,它会关闭操作系统。

有关命令选项的完整列表,请参阅 ibm_is_bare_metal_server