遷移區塊儲存卷

將 Block Storage for VPC 儲存卷從第一代配置檔（分層或自訂）遷移至第二代 sdp 配置檔。在遷移過程中自訂 IOPS 和頻寬，同時維持資料完整性並將停機時間降至最低。

選擇可用性「sdp」設定檔僅限白名單帳戶使用。未列入允許清單的客戶無法透過控制台、命令列介面 (CLI)、API 或 Terraform 啟動遷移至 sdp 的程序。現有的 sdp 卷不受影響。如需更多資訊，請參閱《關於 Block Storage for VPC 》。

建立遷移工作時，您可以自訂 IOPS 和頻寬限制。如果您未指定這些值，系統會套用設定檔的預設值。

遷移進行中時，磁碟區處於 updating 狀態。卷中所有已使用的區域都會被複製，並透過寫入鏡像機制使來源卷與目標卷保持同步。如果該儲存體已掛載至某個執行個體，則在複製操作完成時，該執行個體的儲存體掛載關係將從來源儲存體無縫轉換至目標儲存體。您可以在 UI、CLI、API 和 Terraform 中追蹤遷移工作的狀態和進度。

您可以在複製進程執行時取消遷移。

當遷移完成後，該儲存體將轉為「available」狀態，並採用新設定檔的計費模式。

靜態加密不會受到遷移過程的影響。磁碟區在遷移之前和之後使用相同的 CRK 和 WDEK 加密。

在磁碟區遷移之前拍攝的快照不會隨著磁碟區遷移，其儲存生成值維持不變。遷移後從磁碟區取得的第一個快照是磁碟區的完整複本，並繼承磁碟區的儲存世代值。在第一個快照之後的後續快照成為增量快照。

如果您對已遷移卷的效能或功能不滿意，請建立支援個案以加入允許清單。當您的帳戶在允許清單上時，您可以啟動遷移，讓磁碟區回到第一代。

限制

在此版本中，無法遷移由使用客戶管理金鑰加密的影像所建立的開機磁碟區。
在 24 小時內，每個帳戶最多可對每個區域啟動 10 次遷移。
如果離線移轉正在進行中，則任何新卷附件請求都會失敗。若要繼續處理附件，您必須取消遷移程序。
如果正在進行線上遷移，啟動磁碟區拆離可以取消遷移程序。
在遷移時，無法從磁碟區建立新的快照。
如果某個卷已掛載至使用「匯集頻寬」分配方式的虛擬伺服器執行個體上，則該卷將無法進行遷移。將頻寬分配設定為 weighted，以支援磁碟區遷移程序。
選擇可用性只有那些原本建立為第一代磁碟區的第二代磁碟區才能遷移回第一代設定檔。使用 sdp 設定檔建立的磁碟區無法轉換為第一代設定檔。
選擇可用性如果已遷移的磁碟區容量增加超過 16 TB，就無法遷移回使用第一代設定檔。第一代的傳統配置文件不支援大於 16 TB 的容量。

在主控台中啟動磁碟區遷移

您可以從「行動」功能表，在「Block storage volumes for VPC」清單中選擇 遷移磁碟區，將儲存磁碟區遷移至 sdp 側寫。

前往 Block Storage for VPC 卷冊清單。在 IBM Cloud 主控台中，按一下導覽功能表 > Infrastructure > 儲存 > Block Storage 磁碟區。
請從清單中選取您要遷移的磁碟區。按一下動作功能表，然後按一下遷移磁碟區。

磁碟區遷移一般只適用於第一代磁碟區。對於第二代磁碟區，遷移磁碟區選項只有具有特殊存取權限的帳戶才能看到。
選擇目標設定檔。目前，唯一可用的第二代音量剖面是 sdp。如果要將已遷移的磁碟區還原為第一代設定檔 (general-purpose, 5-iops, 10-iops 或 custom 設定檔)，請選擇支援容量和效能需求的設定檔。無法支援您磁碟區目前容量的設定檔會被停用。
按一下移轉。

從 CLI 啟動磁碟區遷移

您可以使用 volume-job-create 指令，將儲存磁碟區遷移至其他儲存世代的磁碟區設定檔。指定要轉換的磁碟區 ID 或名稱，以及目標磁碟區設定檔。新增 IOPS 和 Bandwidth 值是可選的，並取決於目標磁碟區配置文件。請參閱下列範例。

ibmcloud is volume-job-create r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 --profile sdp --name my-volume-migration-job --iops 3000 --bandwidth 1000

Creating volume job for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name              my-volume-migration-job
Status            queued
Bandwidth(Mbps)   1000
IOPS              3000
Profile           sdp
Auto Delete       false
Created at        2026-03-17T14:26:02+05:30
Href              https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type          migrate
Resource type     volume_job

如需所有可用命令選項的詳細資訊，請參閱 VPC CLI 參考資料。

使用 API 啟動卷遷移

在您開始之前，請確定您已設定好 API 環境。如需詳細資訊，請參閱設定您的 API 和 CLI 環境。

您可以透過 POST /volumes/{volume_id}/jobs 向 VPC API 提出請求，以程式化的方式將儲存卷遷移至其他儲存世代的儲存卷設定檔。指定工作類型「遷移」和目標磁碟區設定檔。當卷遷移至 sdp 設定檔時，您可以選擇指定新的 IOPS 和頻寬值。請參閱下列範例。

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request POST \
  --data '{
    "job_type": "migrate",
    "parameters": {
      "profile": {
        "name": "sdp"
      }
    },
    "name": "my-volume-migration-job"
  }'

成功的回應表示已建立磁碟區移轉工作。

{
  "auto_delete": false,
  "created_at": "2026-03-17T04:15:00.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "job_type": "migrate",
  "name": "my-volume-migration-job",
  "parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
  },
  "resource_type": "volume_job",
  "status": "queued",
  "status_reasons": []
}

使用 Terraform 啟動磁碟區遷移

您可以使用 ibm_is_volume_job 資源，將儲存磁碟區遷移至 sdp 設定檔。指定 job_type "migrate"，以及卷工作的名稱。新增 IOPS 和頻寬值是可選的，並取決於目標磁碟區設定檔。請參閱下列範例。

resource "ibm_is_volume_job" "vol-job1" {
  job_type = "migrate"
  name    = "vol-job1"
  parameters {
    profile {
      name = "sdp"
    }
    bandwidth = 2000
    iops      = 5000
  }
}

遷移工作狀態的遞增

遷移過程並非瞬間完成。遷移的時間長短視卷的大小而定。 1‑TiB 磁碟區的遷移時間通常約為 6 小時。但是，如果同時處理許多卷，遷移可能需要較長時間。

卷工作從 queued 狀態開始，然後移至 running 狀態，當作業成功完成時，再移至 completed 狀態。在遷移過程中，磁碟區生命週期的狀態會顯示為 updating。下表顯示您在檢查移轉進度時，可以在主控台、CLI 和 API 回應中看到的狀態值。

卷工作狀態。
批量作業狀態	活動
`queued`	工作已列隊等待開始。
`running`	這項工作正在進行中。
`failed`	這項工作尚未完成。
`succeeded`	這項工作已順利完成。
`deleting`	該工作正在被刪除。
`deleted`	工作已刪除。
`canceling`	這份工作將被取消。
`canceled`	已取消工作。

在主控台中監控卷遷移

您可以在主控台中檢查磁碟區遷移的狀態和進度。

前往 Block Storage for VPC 卷冊清單。在 IBM Cloud 主控台中，按一下導覽功能表 > Infrastructure > 儲存 > Block Storage 磁碟區。
從清單中，按一下您開始遷移的磁碟區名稱。
按一下磁碟區工作索引標籤，以顯示與磁碟區相關的工作清單。
按一下進行中的移轉工作，以查看狀態和預計完成時間。

從 CLI 監控磁碟區遷移

您可以從 CLI 檢查磁碟區遷移的狀態和進度。首先，使用 ibmcloud is volume-jobs 指令列出所有磁碟區作業，並從輸出中選取一個作業。以下範例使用磁碟區的 ID 來列出相關的磁碟區工作。您也可以使用磁碟區名稱。

ibmcloud is volume-jobs r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3

Listing volume job for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                                         Name       Created at                 Auto Delete  Job type  Status     Bandwidth(Mbps)   IOPS  Profile
r006-10d88923-1102-4859-a2b8-628bb9fb0d70  my-volume-migration-job   2026-03-17T14:26:02+05:30  false        migrate   succeeded  1000              3000  sdp

然後，使用 ibmcloud is volume-job 指令取得卷冊工作的詳細資訊。指定卷名或 ID 作為參數，並指定作業名稱或 ID 作為 --job 選項的一部分。

ibmcloud is volume-job r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 --job r006-10d88923-1102-4859-a2b8-628bb9fb0d70

當遷移正在進行時，回應會與以下範例相似：

ID                        r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name                      my-volume-migration-job
Status                    running
Bandwidth(Mbps)           1000
IOPS                      3000
Profile                   sdp
Auto delete               false
Created at                2026-03-17T10:54:52-06:00
Estimated completion at   2026-03-17T12:03:30-06:00
Href                      https://us-south.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type                  migrate
Started at                2026-03-17T10:55:07-06:00
Resource type             volume_job

在回覆中註明預計完成日期和時間。

當遷移完成時，回應會與以下範例相似：

Getting volume job r006-10d88923-1102-4859-a2b8-628bb9fb0d70 for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name              my-volume-migration-job
Status            succeeded
Bandwidth(Mbps)   1000
IOPS              3000
Profile           sdp
Auto Delete       false
Completed at      2026-03-17T14:26:23+05:30
Created at        2026-03-17T14:26:02+05:30
Href              https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type          migrate
Started at        2026-03-17T14:26:18+05:30
Resource type     volume_job

如需所有可用命令選項的詳細資訊，請參閱 VPC CLI 參考資料。

使用 API 監控卷遷移

您可以使用 API 程式化地檢查磁碟區遷移的狀態和進度。首先，列出磁碟區的移轉工作，並從 API 回應中選擇移轉工作。然後，擷取選取的卷冊工作。

列出卷的移轉工作。以下範例列出磁碟區 r006-567faad4-81f4-440a-95f0-6f4c98f22c25 的移轉工作。

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
 --request GET

成功的回應如下例所示。

{
"first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs?limit=50"
   },
"jobs": [
 {
   "auto_delete": false,
   "created_at": "2026-03-17T06:47:41.000Z",
   "estimated_completion_at": "2026-03-17T06:51:58.000Z",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-45e29fb5-aa4a-4772-a857-da2f31a97726",
   "id": "r006-45e29fb5-aa4a-4772-a857-da2f31a97726",
   "job_type": "migrate",
   "name": "my-volume-migration-job-reverse",
   "parameters": {
     "bandwidth": 1000,
     "iops": 100,
     "profile": {
       "name": "custom"
     }
   },
   "resource_type": "volume_job",
   "started_at": "2026-03-17T06:47:44.000Z",
   "status": "running",
   "status_reasons": [
   ]
 },
 {
   "auto_delete": false,
   "completed_at": "2026-03-17T06:44:29.000Z",
   "created_at": "2026-03-17T06:40:11.000Z",
   "estimated_completion_at": "2026-03-17T06:44:25.000Z",
   "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70",
   "id": "r006-10d88923-1102-4859-a2b8-628bb9fb0d70",
   "job_type": "migrate",
   "name": "my-volume-migration-job",
   "parameters": {
     "bandwidth": 1000,
     "iops": 3000,
     "profile": {
       "name": "sdp"
     }
   },
   "resource_type": "volume_job",
   "started_at": "2026-03-17T06:40:14.000Z",
   "status": "succeeded",
   "status_reasons": [
   ]
 }
],
"limit": 50,
"total_count": 2
}

擷取移轉工作的詳細資訊。以下範例使用先前 API 請求中的磁碟區 ID 006-567faad4-81f4-440a-95f0-6f4c98f22c25 和工作 ID r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d。

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request GET

當工作仍在執行時，成功的回應看起來就像下面的範例。在回覆中註明預計完成的日期和時間。

{
"auto_delete": false,
"created_at": "2026-03-17T04:15:00.000Z",
"estimated_completion_at": "2026-03-17T06:51:58.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"job_type": "migrate",
"name": "my-volume-migration-job",
"parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
},
"resource_type": "volume_job",
"started_at": "2026-03-17T04:15:15.000Z",
"status": "running",
"status_reasons": []
}

工作完成後，成功的回應會像下面的範例。

{
"auto_delete": false,
"completed_at": "2026-03-17T06:44:29.000Z",
"created_at": "2026-03-17T04:15:00.000Z",
"estimated_completion_at": "2026-03-17T06:51:58.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
"job_type": "migrate",
"name": "my-volume-migration-job",
"parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
},
"resource_type": "volume_job",
"started_at": "2026-03-17T04:15:15.000Z",
"status": "running",
"status_reasons": []
}

使用 Terraform 監控卷遷移

使用 ibm_is_volume_job 資源，將屬於磁碟區的磁碟區作業清單匯入為唯讀資料來源。

`data "ibm_is_volume_job" "example" {
  volume_job_id = ibm_is_volume_job.example.id
  }

在主控台中更新磁碟區遷移工作

在移轉工作執行時，如果您需要，也可以更新卷工作的名稱。

前往 Block Storage for VPC 卷冊清單。在 IBM Cloud 主控台中，按一下導覽功能表 > Infrastructure > 儲存 > Block Storage 磁碟區。
從清單中，按一下您開始遷移的磁碟區名稱。
按一下磁碟區工作索引標籤，以顯示與磁碟區相關的工作清單。
請選擇您要更新的工作。按一下動作功能表，然後選擇重新命名。

從 CLI 更新磁碟區移轉工作

在移轉工作執行時，如果您想更新卷工作的名稱，也可以使用 volume-job-update 指令。指定要更新的卷工作的 ID，以及新名稱。

ibmcloud is volume-job-update r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 --volume-job r006-10d88923-1102-4859-a2b8-628bb9fb0d70 --name new-name-for-migration-jon

Updating volume job r006-10d88923-1102-4859-a2b8-628bb9fb0d70 for r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3 under account test account as user test.user@ibm.com...
ID                        r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Name                      new-name-for-migration-job
Status                    running
Bandwidth(Mbps)           1000
IOPS                      3000
Profile                   sdp
Auto Delete               false
Created at                2026-03-17T10:54:52-06:00
Estimated completion at   2026-03-17T12:03:30-06:00
Href                      https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-45421f23-df25-4dc7-bb5a-3cbcec26bba3/jobs/r006-10d88923-1102-4859-a2b8-628bb9fb0d70
Job type                  migrate
Started at                2026-03-17T10:58:52-06:00
Resource type             volume_job

如需所有可用命令選項的詳細資訊，請參閱 VPC CLI 參考資料。

使用 API 更新磁碟區移轉工作

在移轉工作執行時，如果您想更新卷工作的名稱，也可以透過 PATCH/v1/volumes/{volume_id}/jobs/{job_id} 請求進行更新。請參閱下列範例。

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request PATCH \
  --data '{
    "name": "my-updated-migration-job"
  }'

成功的回應顯示卷工作名稱已更新。

{
  "auto_delete": false,
  "created_at": "2026-03-17T04:15:00.000Z",
  "estimated_completion_at": "2026-03-17T06:51:58.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "job_type": "migrate",
  "name": "my-updated-migration-job",
  "parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
  },
  "resource_type": "volume_job",
  "started_at": "2026-03-17T04:15:15.000Z",
  "status": "running",
  "status_reasons": []
}

使用 Terraform 更新磁碟區遷移工作

在移轉工作執行時，如果您想更新卷工作的名稱，也可以使用 ibm_is_volume_job 資源。

`resource "ibm_is_volume_job" "example" {
  volume_job_id = ibm_is_volume_job.example.id
  name          =
  }

在主控台中取消磁碟區遷移

如果移轉工作仍在 queued 或 running 的移轉階段內，您可以取消移轉工作。

前往 Block Storage for VPC 卷冊清單。在 IBM Cloud 主控台中，按一下導覽功能表 > Infrastructure > 儲存 > Block Storage 磁碟區。
從清單中，按一下您開始遷移的磁碟區名稱。
按一下磁碟區工作索引標籤，以顯示與磁碟區相關的工作清單。
請選擇您要更新的工作。按一下動作功能表，然後選擇取消移轉。

從 CLI 取消磁碟區遷移

如果移轉工作仍在移轉階段，您可以使用 volume-job-cancel 指令取消移轉工作。指定您要取消的卷工作的 ID。

ibmcloud is volume-job-cancel r006-ef750f93-70f3-45db-bb10-71901d5371e2 --volume-job r006-55e8105d-61bd-46cc-b714-042eadfc6e17

Cancelling volume job r006-55e8105d-61bd-46cc-b714-042eadfc6e17 for r006-ef750f93-70f3-45db-bb10-71901d5371e2 under account test account as user test.user@ibm.com...
ID                        r006-55e8105d-61bd-46cc-b714-042eadfc6e17
Name                      my-volume-migration-job
Status                    canceling
Bandwidth(Mbps)           1000
IOPS                      3000
Profile                   sdp
Auto delete               false
Created at                2026-03-17T17:24:53+05:30
Estimated completion at   2026-03-17T17:38:39+05:30
Href                      https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ef750f93-70f3-45db-bb10-71901d5371e2/jobs/r006-55e8105d-61bd-46cc-b714-042eadfc6e17
Job type                  migrate
Started at                2026-03-17T17:25:00+05:30
Resource type             volume_job

如需所有可用命令選項的詳細資訊，請參閱 VPC CLI 參考資料。

使用 API 取消磁碟區遷移

如果遷移仍在遷移階段，您可以透過 POST /v1/volumes/{id}/jobs/{job-id}/cancel 向 VPC API 提出請求，以程式方式取消遷移。

curl "$vpc_api_endpoint/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d/cancel?version=2026-03-17&generation=2" \
  --header "Content-Type: application/json" \
  -H "Authorization: Bearer $iam_token" \
  --request POST

成功的回應表示已取消磁碟區移轉工作。

{
  "auto_delete": false,
  "created_at": "2026-03-17T04:15:00.000Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-567faad4-81f4-440a-95f0-6f4c98f22c25/jobs/r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "id": "r006-03edeeed-fae7-439e-b31c-fbdbec6f9e7d",
  "job_type": "migrate",
  "name": "my-volume-migration-job",
  "parameters": {
    "bandwidth": 1000,
    "iops": 3000,
    "profile": {
      "name": "sdp"
    }
  },
  "resource_type": "volume_job",
  "started_at": "2026-03-17T04:15:15.000Z",
  "status": "canceling",
  "status_reasons": []
}

使用 Terraform 取消磁碟區遷移

如果移轉仍在移轉階段，您可以使用 ibm_is_volume_job_operations 資源並加入 cancel = true 參數，取消移轉。

resource "ibm_is_volume_job_operations" "cancel" {
  cancel = true
  volume_job = ibm_is_volume_job.example.id
}

有關參數和屬性的詳細資訊，請參閱 ibm _ is_volume_job_operations。