管理虛擬伺服器實例

從「虛擬伺服器實例」頁面管理實例

您可以透過 IBM Cloud 控制台中的「虛擬伺服器實例」頁面，管理您的 IBM Cloud® Virtual Servers for Virtual Private Cloud 實例。

若要管理實例，請完成下列步驟。

1. 在 IBM Cloud 主控台中，按一下導覽功能表 > Infrastructure > 運算 > 虛擬伺服器實體。
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 變數指定您要檢視之虛擬伺服器實例的 ID 或名稱。

ibmcloud is instance INSTANCE

使用 API 查看實例詳細信息

您可以使用 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 變數指定您要停止的虛擬伺服器實例的 ID 或名稱。

ibmcloud is instance-stop INSTANCE

下列範例會停止實例而不要求確認。 虛擬伺服器實例的 ID 為 0777_e7af506a-35d4-451d-aa9e-59330e62b77e。 --force 選項指出跳過確認要求。

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

_強制停止_操作會觸發虛擬伺服器執行個體的電源循環重設。

如果您的實例停留在 stopping 狀態，則可以搭配使用下列範例指令與指定的 --force 及 --no-wait 選項，以立即停止實例而不進行確認。 實例的 ID 為 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 變數指定您要啟動之虛擬伺服器實例的 ID 或名稱。

ibmcloud is instance-start INSTANCE

如需指令選項的完整清單，請參閱 VPC CLI 參考頁面上的 ibmcloud is instance-start。

使用 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": "stop"}'

如需相關資訊，請參閱 VPC API 中的 建立實例動作。

使用 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 變數指定您要重新開機之虛擬伺服器實例的 ID 或名稱。

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 數量，以提高工作負載管理的靈活性，從而應對資源需求變化、最佳化成本或工作負載效能。 調整大小完成後，您會收到所選新實例設定檔的小時費率帳單。

有關在控制台中調整虛擬伺服器執行個體大小的步驟，請參閱 使用 UI 調整虛擬伺服器實例的大小。

透過命令列介面 (CLI) 調整虛擬伺服器執行個體的大小

您可以增加或減少 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 指令重新載入作業系統。

若您希望保留資料，請在重新安裝作業系統之前，先備份所有資料。

此範例透過 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, 以及相關資料從您的帳戶中永久移除。 如果啟用磁碟區自動刪除設定，也會刪除實體開機磁碟區。 如果在佈建虛擬伺服器實例時連接現有開機磁區，則在刪除實例時，依預設會保留該磁區。 如果在佈建虛擬伺服器實例時建立了開機磁區，則在刪除該實例時，依預設會刪除該磁區。 在確認 delete 動作之後，即會開始刪除實例及其相關聯 vNIC、開機磁區及資料的處理程序。 delete 動作最多可能需要 30 分鐘，但是當處理程序完成時，實例不再出現在「虛擬伺服器實例」頁面上。

從 CLI 刪除虛擬伺服器執行個體

您可以使用指令行介面 (CLI) 來刪除 IBM Cloud VPC 中的虛擬伺服器實例。

如果實例具有浮動 IP 位址，則必須先取消關聯或釋放該實例，然後再刪除該實例。 如果未釋放與浮動 IP 相關聯的帳戶，則會繼續向其收費。

若要刪除虛擬伺服器實例，請使用 ibmcloud is instance-delete 命令。 使用 INSTANCE 變數指定您要刪除之虛擬伺服器實例的 ID 或名稱。

ibmcloud is instance-delete INSTANCE

如需指令選項的完整清單，請參閱 ibmcloud is instance-delete。

「刪除」操作會將該實例、其關聯的 vNIC, 以及相關資料從您的帳戶中永久移除。 如果啟用磁碟區自動刪除設定，也會刪除實體開機磁碟區。 如果在佈建虛擬伺服器實例時連接現有開機磁區，則在刪除實例時，依預設會保留該磁區。 如果在佈建虛擬伺服器實例時建立了開機磁區，則在刪除該實例時，依預設會刪除該磁區。 在確認 delete 動作之後，即會開始刪除實例及其相關聯 vNIC、開機磁區及資料的處理程序。 delete 動作最多可能需要 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, 以及相關資料從您的帳戶中永久移除。 如果啟用磁碟區自動刪除設定，也會刪除實體開機磁碟區。 如果在佈建虛擬伺服器實例時連接現有開機磁區，則在刪除實例時，依預設會保留該磁區。 如果在佈建虛擬伺服器實例的過程中建立開機磁區，則在刪除該實例時，依預設會刪除該磁區。 在確認 delete 動作之後，即會開始刪除實例及其相關聯 vNIC、開機磁區及資料的處理程序。 delete 動作最多可能需要 30 分鐘，但是當處理程序完成時，實例不再出現在「虛擬伺服器實例」頁面上。

如需相關資訊，請參閱 VPC API 中的 刪除實例。

從實例詳細資訊頁面管理實例

若要顯示實例的詳細資訊頁面，請依照以下步驟操作。

1. 在 IBM Cloud 主控台中，按一下導覽功能表 > Infrastructure > 運算 > 虛擬伺服器實體。

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 指令並指定總儲存頻寬（以兆位元每秒 (Mbps) 為單位）total-volume-bandwidth 範圍。 請使用下列語法。 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 模式

您可以變更使用 General purpose - Flex、General purpose Gen 3、Accelerated Gen 3 或 Confidential Computing - Gen 3 設定檔之一的虛擬伺服器實例的儲存 QoS 模式，以啟用附加資料卷的動態頻寬分配。

1. 移至虛擬服務實例。
2. 在虛擬伺服器實例詳細資訊頁面上，按一下切換鍵，將 QoS 模式_從加權切_換為_池狀_。

要使 QoS 模式變更生效，您必須停止並重新啟動虛擬伺服器實例。

從 CLI 調整儲存 QoS 模式

您可以使用 ibmcloud is instance-update 指令變更使用 通用 - Flex、通用 Gen 3、加速 Gen 3 或 保密運算 - Gen 3 設定檔之一的虛擬伺服器實 例的儲存 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 或 Confidential Computing - 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 提供的值是通用的，旨在應用於各種資源，例如 Placement groups。lifecycle_state 可以傳回與 status 重疊的值。lifecycle_state 還包括詳細說明資源是否被掛起的值。

在控制台設定主機故障自動重啟

若要設定現有實例的主機失敗自動重新啟動，請完成下列步驟。

1. 在 IBM Cloud控制台中，點選導航選單圖示> 基礎架構> 計算 > 虛擬伺服器實例。
2. 在 虛擬伺服器實例 頁面上，針對您要管理的實例按一下「動作」圖示 。
3. 從實例詳細資料頁面中，找出「主機失敗自動重新啟動」。 按一下編輯圖示 並選擇啟用或停用以開啟或關閉主機復原策略的狀態。

如需相關資訊，請參閱 主機失敗回復原則。

從 CLI 設定主機故障復原策略

您可以使用命令列介面 (CLI) 更新IBM Cloud® VPC 中的實例並變更主機故障時的可用性原則。 執行 ibmcloud instance-update 指令，並將 --host-failure-policy 內容設為 start 或 stop。 依預設，主機失敗原則服務會設為 restart。 在這裡，INSTANCE 可以是實例的 ID 或名稱。

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 設定機密計算值

選擇可用性

採用 Intel SGX 技術的機密運算服務（適用於虛擬私有雲）與採用 Intel TDX 技術的機密運算服務（適用於虛擬私有雲）現已在達拉斯（us-south）、華盛頓特區（us-east）及法蘭克福（eu-de）區域提供。

您可以使用命令列介面 (CLI) 更新實例並變更 confidential-compute-mode。 使用 ibmcloud is instance-update 命令。 對於 INSTANCE，指定實例的 ID 或名稱，並將 --confidential-compute-mode 屬性設定為 sgx 或 tdx。

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

透過 API 設定機密計算值

選擇可用性

採用 Intel SGX 技術的機密運算服務（適用於虛擬私有雲）與採用 Intel TDX 技術的機密運算服務（適用於虛擬私有雲）現已在達拉斯（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 VPC API 中的 更新實例操作。

使用 Terraform 設定機密運算值

選擇可用性

採用 Intel SGX 技術的機密運算服務（適用於虛擬私有雲）與採用 Intel TDX 技術的機密運算服務（適用於虛擬私有雲）現已在達拉斯（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 啟用和停用安全開機值

選擇 機密運算實例設定檔時，預設會啟用安全開機選項。 您可以停用虛擬伺服器實例上的安全開機，但必須先停止虛擬伺服器實例。 停用安全開機後，您就可以重新啟動虛擬伺服器實例。

您可以使用 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 VPC 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 加入您帳戶現有的 Workload Protection 範例。 如需詳細資訊，請參閱 實施 CSPM(Cloud Security Posture Management)for IBM Cloud。

使用 CLI 檢視虛擬伺服器執行個體的軟體附件

您可以透過 CLI 檢視由目錄映像建立的虛擬伺服器執行個體所附帶的軟體。

• 若要列出某個實例的所有軟體附件，請使用 ibmcloud is instance-software-attachments。 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 為 $software_attachment_id 的軟體附件，該附件對應於實例 ID 為 $instance_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"}'