管理虚拟服务器实例

从“虚拟服务器实例”页面管理实例

您可以在 IBM Cloud 控制台的 “虚拟服务器实例”页面中管理您的 IBM Cloud® Virtual Servers for Virtual Private Cloud 实例。

要管理实例，请完成以下步骤。

1. 在 IBM Cloud 控制台中，单击导航菜单 > 基础架构 > 计算 > 虚拟服务器实例。
2. 在“虚拟服务器实例”页面上，单击要管理的实例的“操作”图标 。 您可以从以下操作中进行选择：

在控制台中重命名虚拟服务器实例

您可以在控制台中重命名虚拟服务器实例。

1. 在 “虚拟服务器实例”页面上，点击要重命名的实例旁边的“操作”图标（ ），然后点击 “重命名”。
2. 输入虚拟服务器实例的新名称，然后单击重命名。

通过命令行界面（CLI）列出虚拟服务器实例

在管理虚拟服务器实例之前，您需要知道其名称或 ID。 要列出您账户中的所有虚拟服务器实例，请使用以下命令。

ibmcloud is instances

有关命令选项的完整列表，请参阅 ibmcloud is instances。

使用 API 列出虚拟服务器实例

在管理虚拟服务器实例之前，您需要获取其 ID。 要列出您账户中的所有虚拟服务器实例，请发送以下请求。

curl -X GET "$vpc_api_endpoint/v1/instances?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

如需了解更多信息，请参阅 VPC API 中的“列出所有实例”。

通过 CLI 查看实例详细信息

您可以使用命令行界面 (CLI) 在 IBM Cloud VPC 中查看虚拟服务器实例详细信息。

要查看虚拟服务器实例详细信息，请使用 ibmcloud is instance 命令。 指定要使用 INSTANCE 变量查看的虚拟服务器实例的标识或名称。

ibmcloud is instance INSTANCE

使用应用程序接口查看实例详情

您可以使用 API 在 IBM Cloud VPC 中查看虚拟服务器实例详细信息。

下面的示例显示了配置文件名称为 "version=2021-06-22&generation=2 的实例配置文件的虚拟服务器实例详细信息。

curl -X GET "$vpc_api_endpoint/v1/instance/profiles/$profile_name?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

有关更多信息，请参阅 VPC API 中的 检索实例概要文件。

使用 Terraform 查看实例详情

您可以使用 Terraform 检索现有虚拟服务器实例的信息。

下面的示例按名称检索虚拟服务器实例的信息：

data "ibm_is_instance" "example" {
  name        = "my-instance"
}

更多信息，请参阅 ibm_is_ instance。

通过命令行界面（CLI）重命名虚拟服务器实例

您可以使用命令行界面 (CLI) 在 IBM Cloud VPC 中重命名虚拟服务器实例。

1. 要重命名虚拟服务器实例，请使用 ibmcloud is instance-update INSTANCE 命令。 使用 --name NEW_NAME 选项指定实例的新名称。

   以下示例将名称为 my-instance-name 的虚拟服务器重命名为 my-instance-name-new。

   ibmcloud is instance-update my-instance-name --name my-instance-name-new
   

   有关命令选项的完整列表，请参阅 ibmcloud is instance-update。

使用 API 重命名虚拟服务器实例

您可以使用 API 在 IBM Cloud VPC 中重命名虚拟服务器实例。

以下示例将虚拟服务器实例从 name 重命名为 my-instance。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-29&generation=2" -H "Authorization: Bearer $iam_token" -d '{"name": "my-instance"}'

使用 Terraform 重命名虚拟服务器实例

您可以使用 Terraform 重命名 IBM Cloud VPC 中的虚拟服务器实例。 更新 ibm_is_instance 资源中的 name 参数。

以下示例将一个虚拟服务器实例重命名为 my-renamed-instance：

resource "ibm_is_instance" "example" {
  name    = "my-renamed-instance"
  # ... other required arguments
}

如需了解更多信息，请参阅资源文档《 ibm_is_instance 》中的 name 参数。

在控制台中停止和启动虚拟服务器实例

从 IBM Cloud 控制台中的“虚拟服务器实例”页面，单击 停止 或 启动。

通过命令行界面（CLI）停止虚拟服务器实例

您可以使用命令行界面 (CLI) 在 IBM Cloud VPC 中停止虚拟服务器实例。

要停止虚拟服务器实例，请使用 ibmcloud is instance-stop 命令。 指定要使用 INSTANCE 变量停止的虚拟服务器实例的标识或名称。

ibmcloud is instance-stop INSTANCE

以下示例停止实例而不请求确认。 虚拟服务器实例的标识为 0777_e7af506a-35d4-451d-aa9e-59330e62b77e。 --force 选项指示将跳过确认请求。

ibmcloud is instance-stop 0777_e7af506a-35d4-451d-aa9e-59330e62b77e --force

_强制停止_操作会触发虚拟服务器实例的电源循环重置。

如果实例处于 正在停止 状态，那么可以将以下示例命令与指定的 --force 和 --no-wait 选项配合使用，以立即停止实例而不进行确认。 实例的标识为 0757_5446c277-3190-48dd-ac67-5f02fab39ed5。 --force 选项指示将跳过确认请求。 --no-wait 选项会立即运行该命令，删除任何排队的操作。

ibmcloud is instance-stop 0757_5446c277-3190-48dd-ac67-5f02fab39ed5 --force --no-wait

有关命令选项的完整列表，请参阅 ibmcloud is instance-stop。

通过命令行界面（CLI）启动虚拟服务器实例

您可以使用命令行界面 (CLI) 来启动在 IBM Cloud VPC 中停止的虚拟服务器实例。

要启动虚拟服务器实例，请使用 ibmcloud is instance-start 命令。 指定要使用 INSTANCE 变量启动的虚拟服务器实例的标识或名称。

ibmcloud is instance-start INSTANCE

有关命令选项的完整列表，请参阅 VPC CLI 参考页面上的 ibmcloud is instance-start。

使用 API 停止虚拟服务器实例

您可以使用 API 来停止 IBM Cloud VPC 中的虚拟服务器实例。

以下示例停止实例标识为 d6c3902d-1ecf-3a2c-b7ab-eb9143581000 的虚拟服务器实例。

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "stop"}'

有关更多信息，请参阅 VPC API 中的 创建实例操作。

使用应用程序接口启动虚拟服务器实例

您可以使用 API 启动在 IBM Cloud VPC 中停止的虚拟服务器实例。

以下示例将启动一个实例 ID 为 d6c3902d-1ecf-3a2c-b7ab-eb9143581000 的虚拟服务器实例。

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "start"}'

有关更多信息，请参阅 VPC API 中的 创建实例操作。

使用 Terraform 停止虚拟服务器实例

您可以使用 Terraform 停止虚拟服务器实例。

下面的示例将停止虚拟服务器实例：

resource "ibm_is_instance_action" "example" {
  action       = "stop"
  force_action = true
  instance     = ibm_is_instance.example.id
}

将 force_action 设置为 true，以强制立即停止并删除所有队列中的操作。

更多信息，请参阅 ibm _ is_instance_action。

使用 Terraform 启动虚拟服务器实例

您可以使用 Terraform 启动已停止的虚拟服务器实例。

下面的示例启动了一个虚拟服务器实例：

resource "ibm_is_instance_action" "example" {
  action   = "start"
  instance = ibm_is_instance.example.id
}

更多信息，请参阅 ibm _ is_instance_action。

在控制台中重启虚拟服务器实例

重新引导操作将触发访客操作系统重新引导。 当访客操作系统正在重新引导时，虚拟服务器实例仍处于正在运行状态。 计费继续。

_强制重启_操作会触发虚拟服务器实例的电源循环重置。

从 IBM Cloud 控制台中的“虚拟服务器实例”页面，单击 重新引导。

通过命令行界面（CLI）重启虚拟服务器实例

重新引导操作将触发访客操作系统重新引导。 当访客操作系统正在重新引导时，虚拟服务器实例仍处于正在运行状态。 计费继续。

使用 --force 选项执行强制重新引导操作将触发虚拟服务器实例的电源循环重置。

您可以使用命令行界面 (CLI) 在 IBM Cloud VPC 中重新引导虚拟服务器实例。

要重启虚拟服务器实例，请使用 ibmcloud is instance-reboot 命令。 使用 INSTANCE 变量指定要重新引导的虚拟服务器实例的标识或名称。

ibmcloud is instance-reboot INSTANCE

有关命令选项的完整列表，请参阅 ibmcloud is instance-reboot。

使用 API 重启虚拟服务器实例

您可以使用 API 在 IBM Cloud VPC 中重新引导虚拟服务器实例。 以下示例重新引导指定的虚拟服务器。

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/d6c3902d-1ecf-3a2c-b7ab-eb9143581000/actions?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token" -d '{"type": "reboot"}'

重新引导操作将触发访客操作系统重新引导。 当访客操作系统正在重新引导时，虚拟服务器实例仍处于正在运行状态。 计费继续。

_强制重启_操作会触发虚拟服务器实例的电源循环重置。

有关更多信息，请参阅 VPC API 中的 创建实例操作。

使用 Terraform 重启虚拟服务器实例

您可以使用 Terraform 重启虚拟服务器实例。

下面的示例重新启动了虚拟服务器实例：

resource "ibm_is_instance_action" "example" {
  action       = "reboot"
  force_action = true
  instance     = ibm_is_instance.example.id
}

重新引导操作将触发访客操作系统重新引导。 当访客操作系统正在重新引导时，虚拟服务器实例仍处于正在运行状态。 计费继续。

_强制重启_操作会触发虚拟服务器实例的电源循环重置。 将 force_action 设置为 true，可立即强制执行操作并删除所有队列中的操作。

更多信息，请参阅 ibm _ is_instance_action。

在控制台中调整虚拟服务器实例的大小

您可以增加或减少可用的vCPU和 RAM 数量，从而提高工作负载管理的灵活性，以应对资源需求变化、优化成本或工作负载性能。 调整大小完成后，将按照所选新实例配置文件的小时费率向您收取费用。

有关在控制台中调整虚拟服务器实例大小的步骤，请参阅 使用用户界面调整虚拟服务器实例大小。

通过命令行界面调整虚拟服务器实例的规格

您可以增加或减少 vCPU 和 RAM 的可用数量，从而提高工作负载管理的灵活性，以应对资源需求变化、优化成本或工作负载性能。 调整大小完成后，将按照所选新实例配置文件的小时费率向您收取费用。

有关调整虚拟服务器实例大小的步骤，请参阅 使用 CLI 调整虚拟服务器实例大小。

使用 API 调整虚拟服务器实例的大小

您可以增加或减少 vCPU 和 RAM 的可用数量，从而提高工作负载管理的灵活性，以应对资源需求变化、优化成本或工作负载性能。 调整大小完成后，将按照所选新实例配置文件的小时费率向您收取费用。

有关调整虚拟服务器实例大小的步骤，请参阅 使用 API 调整虚拟服务器实例大小。

使用 Terraform 调整虚拟服务器实例的规格

您可以通过更新 ibm_is_instance 资源中的 profile 参数，来增加或减少可用的 vCPU 和RAM容量，从而在工作负载管理方面获得更大的灵活性。 调整规格完成后，系统将根据新实例配置的每小时费率向您收费。

以下示例更新了虚拟服务器实例的配置文件：

resource "ibm_is_instance" "example" {
  name    = "my-instance"
  profile = "bx2-4x16"
  # ... other required arguments
}

如需了解更多信息，请参阅资源文档《 ibm_is_instance 》中的 profile 参数。

使用命令行界面（CLI）重新加载操作系统

您可以使用命令行界面（CLI）重新加载操作系统。 请使用以下 CLI 命令重新加载操作系统。

如果您希望保留数据，请在重新安装操作系统之前备份所有数据。

此示例通过使用 IMAGE，并结合 BOOT_VOLUME_JSON 中包含的启动卷选项，重新初始化 INSTANCE。 它使用 KEY1 和 KEY2 作为密钥，DEFAULT_TRUSTED_PROFILE 作为默认受信任配置文件，DATA 作为用户数据。 由于将 --default-trusted-profile-auto-link 设置为 true，因此默认受信任配置文件会被自动关联。

ibmcloud is instance-reinitialize INSTANCE --image IMAGE --boot-volume BOOT_VOLUME_JSON --keys KEY1,KEY2 --default-trusted-profile DEFAULT_TRUSTED_PROFILE --default-trusted-profile-auto-link true --user-data DATA

使用 API 重载操作系统

您可以使用 API 重新加载操作系统。 请使用以下 API 调用重新加载操作系统。

如果您希望保留数据，请在重新安装操作系统之前备份所有数据。

此示例使用映像 image_id 并采用提供的启动卷挂载选项，对实例 instance_id 进行重新初始化。 它使用 key_id 作为密钥，some_data 作为用户数据，并使用 profile_id 作为默认的可信配置文件。 默认受信任配置文件已被关联，因为“auto_link”已设置为“true”。

curl -X POST "https://us-south.iaas.cloud.ibm.com/v1/instances/instance_id/reinitialize?version=2026-07-01&generation=2" -H "Authorization: Bearer $iam_token" -d
'{
    "image": {
         "id": "image_id"
    },
    "boot_volume_attachment": {
      "volume":  {
        "profile": {
          "name": "general-purpose"
          }
        }
      },"keys": [{
        "id": "key_id"
	}],
	"user_data": "some_data",
	"default_trusted_profile": {
      "target": {
	    "id": "profile_id"
	   },
	   "auto_link": true
	}
}'

在控制台中删除虚拟服务器实例

您可以在控制台中删除IBM Cloud VPC中的虚拟服务器实例。

如果实例具有浮动 IP 地址，那么必须先将其取消关联或释放，然后才能删除该实例。 如果未释放与浮动 IP 关联的帐户，那么将继续对其收费。

从 IBM Cloud 控制台中的“虚拟服务器实例”页面，单击 删除。

“删除”操作将永久从您的账户中移除该实例、其关联的 vNIC, 以及相关数据。 如果启用了卷自动删除设置，实例启动卷也会被删除。 如果在供应虚拟服务器实例的过程中附加了现有引导卷，那么缺省情况下，删除该实例时将保留该卷。 如果在供应虚拟服务器实例的过程中创建了引导卷，那么缺省情况下，删除该实例时将删除该卷。 确认删除操作后，删除实例及其关联的 vNIC、引导卷和数据的过程随即开始。 删除操作可能最长需要 30 分钟时间，但是此过程完成后，该实例不会再显示在“虚拟服务器实例”页面上。

通过 CLI 删除虚拟服务器实例

您可以使用命令行界面 (CLI) 在 IBM Cloud VPC 中删除虚拟服务器实例。

如果实例具有浮动 IP 地址，那么必须先将其取消关联或释放，然后才能删除该实例。 如果未释放与浮动 IP 关联的帐户，那么将继续对其收费。

要删除虚拟服务器实例，请使用 ibmcloud is instance-delete 命令。 使用 INSTANCE 变量指定要删除的虚拟服务器实例的标识或名称。

ibmcloud is instance-delete INSTANCE

有关命令选项的完整列表，请参阅 ibmcloud is instance-delete。

“删除”操作将永久从您的账户中移除该实例、其关联的 vNIC, 以及相关数据。 如果启用了卷自动删除设置，实例启动卷也会被删除。 如果在供应虚拟服务器实例的过程中附加了现有引导卷，那么缺省情况下，删除该实例时将保留该卷。 如果在供应虚拟服务器实例的过程中创建了引导卷，那么缺省情况下，删除该实例时将删除该卷。 确认删除操作后，删除实例及其关联的 vNIC、引导卷和数据的过程随即开始。 删除操作可能最长需要 30 分钟时间，但是此过程完成后，该实例不会再显示在“虚拟服务器实例”页面上。

使用 API 删除虚拟服务器实例

您可以使用 API 在 IBM Cloud VPC 中删除虚拟服务器实例。

如果实例具有浮动 IP 地址，那么必须先将其取消关联或释放，然后才能删除该实例。 如果未释放与浮动 IP 关联的帐户，那么将继续对其收费。

以下示例将删除实例。

curl -X DELETE "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-22&generation=2" -H "Authorization: Bearer $iam_token"

“删除”操作将永久从您的账户中移除该实例、其关联的 vNIC, 以及相关数据。 如果启用了卷自动删除设置，实例启动卷也会被删除。 如果在供应虚拟服务器实例的过程中附加了现有引导卷，那么缺省情况下，删除该实例时将保留该卷。 如果在供应虚拟服务器实例的过程中创建了引导卷，那么缺省情况下，删除该实例时将删除该卷。 确认删除操作后，删除实例及其关联的 vNIC、引导卷和数据的过程随即开始。 删除操作可能最长需要 30 分钟时间，但是此过程完成后，该实例不会再显示在“虚拟服务器实例”页面上。

有关更多信息，请参阅 VPC API 中的 删除实例。

从实例详情页面管理实例

要显示实例的详细信息页面，请按照以下步骤操作。

1. 在 IBM Cloud 控制台中，单击导航菜单 > 基础架构 > 计算 > 虚拟服务器实例。

2. 在 “虚拟服务器实例”页面上的列表中，找到您要查看的实例。 点击实例名称可查看其详细信息。 实例详细信息页面分为五个选项卡：“概览”、“网络”、“存储”、“监控”和 “集成”。

在控制台中查看实例详细信息

在“虚拟服务器实例”页面上，单击某个虚拟服务器实例的名称，即可打开其详细信息页面。 详情页分为以下几个标签页。

在控制台中更改连接到实例的卷的自动删除设置

在实例配置过程中，创建的启动卷默认已启用自动删除选项。 启用此功能后，删除实例时卷也会被删除。

对于在实例调配过程中创建的数据卷，情况正好相反，自动删除功能被禁用。 默认情况下，数据卷可以被分离，但不会被删除，这样您的数据就可以在虚拟服务器实例生命周期之后继续存在。

您可以在创建实例时在“编辑启动卷”面板上或稍后在实例详细信息页面中更改此设置。 有关详细信息，请参阅 创建虚拟服务器实例 和 更新卷的自动删除设置。

通过 CLI 更改连接到实例的卷的自动删除设置

在实例配置过程中，创建的启动卷默认已启用自动删除选项。 启用此功能后，删除实例时卷也会被删除。

对于在实例调配过程中创建的数据卷，情况正好相反，自动删除功能被禁用。 默认情况下，数据卷可以被分离，但不会被删除，这样您的数据就可以在虚拟服务器实例生命周期之后继续存在。

创建实例或更新启动卷附件时，可以通过指定 auto_delete 属性来更改此设置。 有关更多信息，请参阅 创建虚拟服务器实例 和 从 CLI 更新卷附件。

使用 API 更改连接到实例的卷的自动删除设置

在实例配置过程中，创建的启动卷默认已启用自动删除选项。 启用此功能后，删除实例时卷也会被删除。

对于在实例调配过程中创建的数据卷，情况正好相反，自动删除功能被禁用。 默认情况下，数据卷可以被分离，但不会被删除，这样您的数据就可以在虚拟服务器实例生命周期之后继续存在。

创建实例 或更新 卷附件 时，可以通过指定 delete_volume_on_instance_delete 属性来更改此设置。 有关详细信息，请参阅 创建虚拟服务器实例 和 使用 API 更新卷附件。

使用 Terraform 更改附加到实例的卷的自动删除设置

在实例配置过程中，系统会创建一个启动卷，默认情况下会启用 auto_delete_volume 选项。 启用此选项后，删除实例时将删除启动卷。

您可以通过更新 ibm_is_instance 资源中的 auto_delete_volume 参数来更改此设置。

以下示例将禁用启动卷的自动删除功能：

resource "ibm_is_instance" "example" {
  name              = "my-instance"
  auto_delete_volume = false
  # ... other required arguments
}

如需了解更多信息，请参阅资源文档《 ibm_is_instance 》中的 auto_delete_volume 参数。

在控制台中调整实例带宽分配

您可以在控制台中调整实例总带宽在网络带宽和存储带宽之间的分配。

要调整实例的带宽，请使用以下步骤。

1. 转至虚拟服务实例。
2. 选择 带宽分配。
3. 在“编辑带宽分配”屏幕上，调整 存储带宽的值。 您可以增加为 Block Storage 引导和连接的数据卷分配的带宽。 有关存储带宽分配的更多信息，请参阅 Block Storage卷的带宽分配。 设置存储带宽后，将自动调整网络带宽，以使实例的总带宽等于显示的总带宽值。 网络带宽或存储器带宽的值不能设置为小于 500 Mbps。

要查看新的带宽分配，必须停止并启动实例，或者拆离并重新连接辅助卷。

通过 CLI 调整实例带宽分配

您可以使用 CLI 在网络带宽和存储带宽之间调整实例的总带宽分配。

要重新分配实例带宽，请运行 instance-update 命令，并为 total-volume-bandwidth 参数指定总存储带宽（单位：兆比特/秒 (Mbps)）。 使用以下语法。 在 INSTANCE 中使用实例的 ID 或名称。

ibmcloud is instance-update INSTANCE --total-volume-bandwidth VALUE

总存储带宽（单位：兆比特/秒）是为启动卷和附加数据卷分配的总带宽。 增加总存储带宽会导致网络带宽相应减少。 最低网络带宽为 500 Mbps，因此请根据需要调整总存储带宽。

要查看新的带宽分配，必须停止并启动实例，或分离并重新连接数据卷。

使用 API 调整实例带宽分配

您可以使用 API 调整现有实例的总存储带宽。 提出 PATCH /instances 请求，并为 total_volume_ bandwidth 指定一个新值。 总存储带宽 (以兆位/秒为单位) 是分配给主引导数据卷和辅助连接数据卷的总带宽。 增加总存储带宽会导致网络带宽相应减少。 最低网络带宽为 500 Mbps，因此请根据需要调整总存储带宽。 例如，

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2021-06-22&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "total_volume_bandwidth": 500
      }'

要查看新的带宽分配，必须停止并启动实例，或分离并重新连接数据卷。 使用 POST / volume_attachments 方法添加数据卷或使用 DELETE volume_attachments 方法删除卷时，将更新单个卷的带宽分配。

使用 Terraform 调整实例带宽分配

您可以通过更新 ibm_is_instance 资源中的 total_volume_bandwidth 参数，来调整实例总带宽在网络带宽和存储带宽之间的分配比例。 总存储带宽（单位：兆比特每秒）是指为启动卷和已挂载的数据卷分配的总带宽。 增加总存储带宽会导致网络带宽相应减少。 网络带宽下限为 500 Mbps。

以下示例将总存储带宽设置为 500 Mbps：

resource "ibm_is_instance" "example" {
  name                   = "my-instance"
  total_volume_bandwidth = 500
  # ... other required arguments
}

要查看新的带宽分配，必须停止并启动实例，或分离并重新连接数据卷。

如需了解更多信息，请参阅资源文档《 ibm_is_instance 》中的 total_volume_bandwidth 参数。

在控制台中调整存储 QoS 模式

您可以更改使用 通用 - Flex、通用 Gen 3、加速 Gen 3 或 机密计算 - Gen 3 配置文件之一的虚拟服务器实例的 Storage QoS 模式，以便为所连接的数据卷启用动态带宽分配。

1. 转至虚拟服务实例。
2. 在虚拟服务器实例详细信息页面上，单击切换按钮将 QoS 模式从_加权_模式切换为_池化_模式。

要使 QoS 模式更改生效，必须停止并重新启动虚拟服务器实例。

通过 CLI 调整存储 QoS 模式

虚拟服务器实例使用 通用 - Flex、通用 Gen 3、加速 Gen 3 或 机密计算 - Gen 3 配置文件之一，您可以使用 ibmcloud is instance-update 命令更改虚拟服务器实例的 Storage QoS 模式，以便为所连接的数据卷启用动态带宽分配。

ibmcloud is instance-update INSTANCE --storage_qos_modes pooled

您可以使用相同的命令恢复到加权 QoS 模式。

ibmcloud is instance-update INSTANCE --storage_qos_modes weighted

要使 QoS 模式更改生效，您必须先停止虚拟服务器实例。 运行 instance-update 命令。 然后，启动实例。

使用 API 调整存储 QoS 模式

您可以通过调用 VPC API 中的 /instances/{id} 方法，以编程方式更改使用 通用 - Flex、通用 Gen 3、 加速 Gen 3 或 机密计算 - Gen 3 配置文件之一的虚拟服务器实例的存储 QoS 模式，如以下示例请求所示。

以下示例请求可为连接到第三代虚拟服务器的数据卷动态分配带宽。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-07-11&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "storage_qos_mode": "pooled"
      }'

下面的示例请求将 QoS 存储模式恢复为加权模式。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-07-11&generation=2" \
  -H "Authorization: Bearer $iam_token" \
  -d '{
      "storage_qos_mode": "weighted"
      }'

要使 QoS 模式更改生效，您必须先停止虚拟服务器实例。 提出 PATCH 申请。 然后，启动实例。

在 API 中查看实例状态和 lifecycle_state

• status
• 此属性通过 检索实例 请求提供虚拟服务器实例的状态。 status 返回的值是虚拟服务器实例的专用值，表示虚拟服务器实例正在运行、停止或过渡。 有关更多信息，请参阅 Virtual Private Cloud API。
• lifecycle_state
• 此属性通过 检索实例 请求提供资源的状态。 lifecycle_state 提供的值是通用的，适用于各种资源，如 安置组。lifecycle_state 可以返回与 "status 重叠的值。lifecycle_state 还包括详细说明资源是否被暂停的值。

在控制台中设置主机故障自动重启

要为现有实例设置主机故障自动重新启动，请完成以下步骤。

1. 在 IBM Cloud 控制台，单击 导航菜单 图标 > 基础设施 > 计算 > 虚拟服务器实例。
2. 在“虚拟服务器实例”页面上，单击要管理的实例的“操作”图标 。
3. 在实例详细信息页面中，找到“主机故障自动重新启动”。 单击 Edit 图标 并选择已启用或已禁用，以切换主机恢复策略的开启或关闭状态。

有关更多信息，请参阅 主机故障恢复策略。

通过 CLI 设置主机故障恢复策略

您可以使用命令行界面（CLI）更新 "IBM Cloud®VPC 中的实例，并更改主机故障时的可用性策略。 运行 ibmcloud instance-update 命令并将 --host-failure-policy 属性设置为 start 或 stop。 缺省情况下，主机故障策略服务设置为 restart。 在这里，INSTANCE 可以是实例的标识或名称。

ibmcloud is instance-update INSTANCE --total-volume-bandwidth VALUE --host-failure-policy stop

使用 API 设置主机故障恢复策略

在实例 更新 期间，“host_failure 子属性可用于设置虚拟服务器实例的主机故障”availability_policy。

使用 Terraform 设置主机故障恢复策略

您可以通过更新 ibm_is_instance 资源中的 availability_policy_host_failure 参数，为虚拟服务器实例设置主机故障恢复策略。 缺省值为 restart。

以下示例将策略设置为 stop：

resource "ibm_is_instance" "example" {
  name                              = "my-instance"
  availability_policy_host_failure  = "stop"
  # ... other required arguments
}

如需了解更多信息，请参阅资源文档《 ibm_is_instance 》中的 availability_policy_host_failure 参数。

通过 CLI 设置机密计算值

选择可用性

基于英特尔SGX的VPC机密计算和基于英特尔TDX的VPC机密计算已在达拉斯（us-south）、华盛顿特区（us-east）和法兰克福（eu-de）区域开放使用。

您可以使用命令行界面（CLI）更新实例并更改 "confidential-compute-mode。 使用 "ibmcloud is instance-update 命令。 对于实例，请指定实例的ID或名称，并将 --confidential-compute-mode 属性设置为 sgx 或 tdx。

ibmcloud is instance-update INSTANCE --confidential-compute-mode sgx

通过 API 设置机密计算值

选择可用性

基于英特尔SGX的VPC机密计算和基于英特尔TDX的VPC机密计算已在达拉斯（us-south）、华盛顿特区（us-east）和法兰克福（eu-de）区域开放使用。

您可以使用 API 更新虚拟服务器实例并更改 "confidential_compute_mode 属性。 使用 ibmcloud 'update-instance 命令。 提出“PATCH /instances 请求，并为”confidential_compute_mode 属性指定一个新值。 为了启用保密计算，请将此值更改为 sgx 或 tdx。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"confidential_compute_mode": "sgx"}'

更多信息，请参阅Virtual Servers for VPCAPI 中的 更新实例操作。API 中的更新实例操作。

使用 Terraform 设置机密计算值

选择可用性

基于英特尔SGX的VPC机密计算和基于英特尔TDX的VPC机密计算已在达拉斯（us-south）、华盛顿特区（us-east）和法兰克福（eu-de）区域开放使用。

您可以通过更新 ibm_is_instance 资源中的 confidential_compute_mode 参数，来更新虚拟服务器实例的机密计算模式。

以下示例启用了 SGX 机密计算：

resource "ibm_is_instance" "example" {
  name                     = "my-instance"
  confidential_compute_mode = "sgx"
  # ... other required arguments
}

如需了解更多信息，请参阅资源文档《 ibm_is_instance 》中的 confidential_compute_mode 参数。

在控制台中禁用或启用安全启动

选择 保密计算实例配置文件 时，默认情况下会启用安全启动选项。 您可以在虚拟服务器实例上禁用安全启动，但必须首先停止虚拟服务器实例。 禁用安全启动后，就可以重新启动虚拟服务器实例。

1. 从 IBM Cloud 控制台的_虚拟服务器实例_页面，选择虚拟服务器实例。
2. 从“操作”中单击“停止”。
3. 在高级配置详细信息中，将安全启动切换为禁用。
4. 从“操作”中单击“开始”。

如果决定重新启用安全启动，请按照同样的步骤，将选项切换回启用

通过 CLI 启用和禁用安全启动

选择 保密计算实例配置文件 时，默认情况下会启用安全启动选项。 您可以在虚拟服务器实例上禁用安全启动，但必须首先停止虚拟服务器实例。 禁用安全启动后，就可以重新启动虚拟服务器实例。

您可以使用命令行界面（CLI）更新实例并更改 "enable-secure-boot。 使用 "ibmcloud is instance-update 命令。 对于 INSTANCE，请指定实例的 ID 或名称，并将“--enable-secure-boot 属性设置为”false。

ibmcloud is instance-update INSTANCE --enable-secure-boot false

如果决定重新启用安全启动，请按照相同步骤操作，并将 --enable-secure-boot 属性设置为 true。

通过应用程序接口启用和禁用安全启动值

选择 保密计算实例配置文件 时，默认情况下会启用安全启动选项。 您可以在虚拟服务器实例上禁用安全启动，但必须首先停止虚拟服务器实例。 禁用安全启动后，就可以重新启动虚拟服务器实例。

您可以使用 API 更新虚拟服务器实例并更改 "enable_secure_boot 属性。 发出一个 PATCH /instances 请求，并为 enable_secure_boot 属性指定一个布尔值。 以下示例将禁用安全启动：

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"enable_secure_boot": false}'

如果决定重新启用安全启动，请按照相同步骤操作，并将 enable_secure_boot 属性设置为 true。

更多信息，请参阅Virtual Servers for VPCAPI 中的 更新实例操作。API 中的更新实例操作。

在控制台中将服务器从预订中分离

您可以在控制台中将虚拟服务器从预订中分离。

1. 在 控制 IBM Cloud 台中，单击导航菜单 标 > 基础设施 > 预留实例。
2. 从虚拟服务器列表或“预留详细信息”页面中，单击要拆离的服务器，然后单击 操作 > 拆离。
3. 要确认，请单击 拆离。

通过命令行界面（CLI）将服务器从预留中移除

有关如何使用 CLI 将虚拟服务器从预留中解除绑定的步骤，请参阅 《管理 VPC 预留》。

使用 API 将服务器从预留中移除

有关如何使用 API 将虚拟服务器从预留中解绑的操作步骤，请参阅《 管理 VPC 预留 》。

在控制台中添加 CSPM

选择该选项后，将创建一个工作负载保护实例，其配置可为所有资源提供 CSPM。 如果存在工作负载保护实例，则无法使用该选项。 更多信息，请参阅 关于 IBM Cloud Security Posture Management(CSPM)。

您可以在_虚拟服务器实例_页面添加 CSPM (Cloud Security Posture Management )。

1. 从 IBM Cloud 控制台的_虚拟服务器实例_页面，单击单个实例名称查看详细信息。
2. 在详情页面中，转到 “集成”选项卡。
3. 在云安全态势管理中，单击添加 CSPM。
4. 在添加云安全态势管理 (CSPM) 上，单击创建。

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

使用 CLI 查看虚拟服务器实例的软件附件

您可以使用命令行界面（CLI）查看由目录映像创建的虚拟服务器实例的软件附件。

• 要列出实例的所有软件附件，请使用 [ibmcloud is instance-software-attachments](/docs/vpc?topic=vpc-vpc-reference#instance-software-attachments-list. INSTANCE 变量是该实例的ID或名称。

ibmcloud is instance-software-attachments INSTANCE [--output JSON] [-q, --quiet]

以下示例列出了实例 my-instance 的所有软件附件。

ibmcloud is instance-software-attachments my-instance

• 要查看实例中某个特定软件附件的详细信息，请使用 ibmcloud is instance-software-attachment。 INSTANCE 变量是该实例的ID或名称。 SWAC 变量是实例软件附件的ID或名称。

ibmcloud is instance-software-attachment INSTANCE SWAC [--output JSON] [-q, --quiet]

以下示例展示了实例 my-instance 的软件附件 my-software-attachment 的详细信息。

ibmcloud is instance-software-attachment my-instance my-software-attachment

使用命令行界面（CLI）更新虚拟服务器实例的软件附件

您可以使用命令行界面（CLI）更新由目录映像创建的虚拟服务器实例的软件附件。

要更新实例中某个软件附件的名称，请使用 ibmcloud is instance-software-attachment-update。 INSTANCE 变量是该实例的ID或名称。 SWAC 变量是实例软件附件的ID或名称。 --name 的值即为该实例软件附件的新名称。

ibmcloud is instance-software-attachment-update INSTANCE SWAC --name NEW_NAME [--output JSON] [-q, --quiet]

以下示例将实例 my-instance 上的软件附件 $software_attachment_id 重命名为 my-renamed-software-attachment。

ibmcloud is instance-software-attachment-update my-instance my-software-attachment --name my-renamed-software-attachment

使用 API 查看虚拟服务器实例的软件附件

当您创建基于目录镜像的虚拟服务器实例时，可以使用已专门配置了特定软件计费方案的目录镜像。 创建虚拟服务器实例后，您可以查看现已作为该虚拟服务器实例组成部分的软件附件。

若要通过 API 查看软件附件，请发送一个 GET /instances/{instance_id}/software_attachments 请求。

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/{instance_id}/software_attachments?version=2026-04-21" -H "Authorization: Bearer $iam_token"

使用 API 列出实例软件附件

您可以通过调用 VPC API，以编程方式列出与某个虚拟服务器实例关联的所有软件附件。

以下示例列出了实例 ID 为 $instance_id 的实例的所有软件附件。

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

如需了解更多信息，请参阅 VPC API 中的 “列出与实例关联的实例软件附件”。

使用 API 检索实例软件附件

您可以通过发送一个 GET /instances/{instance_id}/software_attachments/{id} 请求，并指定实例软件附件 ID 和实例 ID，来检索单个实例软件附件。

以下示例用于检索ID为 $software_attachment_id 的特定软件附件，该附件属于实例ID为 $instance_id 的实例。

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments/$software_attachment_id?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token"

如需了解更多信息，请参阅 VPC API 中的 “检索实例软件附件”。

使用 API 更新实例软件附件

您可以通过发送一个 PATCH /instances/{instance_id}/software_attachments/{id} 请求，并指定实例软件附件 ID 和实例 ID，来更新实例软件附件。

以下示例更新了实例 ID 为 $instance_id 的实例中 ID 为 $software_attachment_id 的软件附件。

curl -X PATCH "https://us-south.iaas.cloud.ibm.com/v1/instances/$instance_id/software_attachments/$software_attachment_id?version=2024-06-23&generation=2" -H "accept: application/json" -H "Authorization: Bearer $iam_token" -H "Content-Type: application/merge-patch+json" -d "{\"name\":\"my-software-attachment-patch\"}"

如需了解更多信息，请参阅 VPC API 中的 “更新实例软件附件”。

在控制台中编辑“每个内核的线程数”

“每核线程数”功能为您提供了优化工作负载的灵活性。 虽然所有配置文件都会显示“每核线程数”，但您只能对 “高频”配置文件系列进行编辑。 对于高频配置文件，默认值为 2。 您可以将此值调整为 1。

虽然所有配置文件都会显示“每核线程数”，但您只能对 “高频”配置文件系列进行编辑。 在更改 threads_per_core 属性之前，必须先停止虚拟服务器实例。

1. 从 IBM Cloud 控制台的_虚拟服务器实例_页面，单击单个实例名称查看详细信息。
2. 在详情页面中，访问 Profiles details，然后访问 Threads per core。 请点击 Edit。
3. 在“每个核心的线程数”页面中，编辑“每个核心的线程数”的数值。
4. 单击 Save。

使用命令行界面（CLI）编辑“每个内核的线程数”

“每核线程数”功能为您提供了优化工作负载的灵活性。 虽然所有配置文件都会显示“每核线程数”，但您只能对 “高频”配置文件系列进行编辑。 对于高频配置文件，默认值为 2。 您可以将此值调整为 1。

在修改 threads_per_core 属性之前，必须先停止虚拟服务器实例。

您可以使用命令行界面（CLI）编辑 IBM Cloud VPC 中虚拟服务器实例的 --threads-per-core 值。 要更新 --threads-per-core 的值，请使用 ibmcloud is instance-update 命令。 请使用 INSTANCE 变量指定要更新的虚拟服务器实例的ID或名称。 对于“--threads-per-core”选项，请输入 1 或 2 中的任意一个。

ibmcloud is instance-update INSTANCE --threads-per-core [1]

使用 API 编辑“每个核心的线程数”

“每核线程数”功能为您提供了优化工作负载的灵活性。 虽然所有配置文件都会显示“每核线程数”，但您只能对 “高频”配置文件系列进行编辑。 对于高频配置文件，默认值为 2。 您可以将此值调整为 1。

在更改 threads_per_core 属性之前，必须先停止虚拟服务器实例。

您需要通过 API 编辑 IBM Cloud VPC 中虚拟服务器实例的 threads_per_core 属性。 使用 "update-instance 命令。 提出“PATCH /instances 请求，并为”threads_per_core 属性指定一个新值。

curl -X PATCH "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-10-17&generation=2" -H "Authorization: Bearer $iam_token" -d '{"threads_per_core": "1"}'