建立 Block Storage for VPC 磁區

在實例配置過程中建立 IBM Cloud 區塊儲存卷，可作為獨立卷，或透過從快照還原來建立。設定容量、IOPS 及加密功能。

開始之前，請確保您已建立 VPC。當您從快照建立磁碟區時，您可以使用您自己的帳戶或其他帳戶的快照。如果您打算使用其他帳戶的快照，請確保具備正確的 IAM 授權。

選擇可用性 sdp 設定檔僅限白名單帳戶使用。未列入允許清單的客戶無法在控制台、透過 CLI、API 或 Terraform 檢視或配置 sdp 儲存卷。現有的 sdp 卷不會受到影響。如需更多資訊，請參閱《關於 Block Storage for VPC 》。

Hyper Protect Crypto Services 已被標記為過時。客戶可在 2027 年 3 月 20 日前使用現有的實體。如需更多資訊，請參閱《 IBM Cloud Hyper Protect Crypto Services 已停用》。為了持續確保安全性，請考慮將現有的加密金鑰遷移至專用的 Key Protect 執行個體。如需更多資訊，請參閱《遷移指南》。

創造Block Storage for VPC控制台中的音量

當您建立虛擬伺服器實例或作為獨立式磁區時，請使用 IBM Cloud 主控台來建立 Block Storage for VPC 磁區。

建立實例時建立並連接 Block Storage for VPC 磁區

在 IBM Cloud控制台中，點選導航選單圖示> 基礎架構> 計算 > 虛擬伺服器實例。
從虛擬伺服器實例清單中，按一下建立。
在 VPC 佈建的虛擬伺服器頁面中，選取伺服器類型、位置、OS、設定檔、放置群組等。如需佈建實例的相關資訊，請參閱使用使用者介面建立虛擬伺服器實例。
頁面上會顯示要建立之開機磁區的詳細資料。您可以點擊「編輯圖示 」來編輯開機磁碟區，藉此變更容量、設定加密，並新增任何使用者標籤以識別此資源。您可以將個人檔案變更為 general-purpose。已列入白名單的帳戶亦可選擇「sdp」個人檔案。
若要建立資料卷並將其附加到實例，請在數據量在實例配置頁面的部分，按一下創造。在側邊畫面中，指定磁區詳細資料。
1. 您可以建立空白的資料磁碟區，或建立具有從快照匯入資料的磁碟區。如果選擇匯入現有快照，則從清單中選擇可用的快照。如果您選擇依 CRN 匯入快照，請準備好要輸入的快照 CRN。
2. 請為您的磁碟區指定一個唯一且具意義的名稱。例如，這可以是一個能描述您的運算或工作負載功能的名稱。卷名必須以小寫字母開頭。名稱最多可包含 63 個小寫字母數字字元，並包含連字號 (-)。磁碟區名稱對於您的 VPC 必須是唯一的。如果您願意，稍後可以編輯這個名稱。
3. 「自動刪除」功能預設為停用狀態。如果您希望在刪除附加的虛擬伺服器執行個體時刪除該卷，請按一下切換開關以啟用該功能。
4. 資源組和位置繼承自實例。這些值無法變更。
5. 您可以指定與此磁碟區關聯的選用使用者標籤。如需使用使用者標籤來組織資源的相關資訊，請參閱使用標籤。
6. 在「加密」區段中，預設已啟用由供應商管理的加密功能。若要使用您自己的加密金鑰，請點擊切換按鈕以啟用客戶自管加密功能。如果您已經擁有 KMS 實例和根金鑰，系統會自動為您選取該實例。您可以點擊「編輯圖示 」以切換至其他金鑰或執行個體。若要找到您的加密金鑰，請選擇以下選項之一：
  - 依執行個體搜尋：此面板包含三個步驟：
    1. 選擇 KMS 執行個體：此清單顯示每個可用 Key Protect 執行個體的名稱、ID、類型（標準型或專用型）以及位置。選取一個執行個體，然後按一下「選取」。如果您還沒有實例，請點擊「建立」以配置一個。
    2. 關聯金鑰：此清單顯示每個可用根金鑰的名稱、ID、最後更新日期、別名及金鑰圈。選擇一個鍵，然後按一下「選取」。如果您還沒有金鑰，請點擊「建立新金鑰」。
    3. 檢視：請確認您的選項，包括金鑰管理服務、執行個體類型、執行個體名稱及金鑰名稱。「服務授權」區段會顯示 Block Storage for VPC 與 KMS 執行個體之間是否已建立所需的授權關係。若非如此，您可以讓 Key Protect 自動建立授權，或手動建立一個。如需更多資訊，請參閱《為 Block Storage for VPC 建立服務對服務授權》。按下「確認」以套用您的選項，並返回磁碟區設定畫面。
  - 透過 CRN 定位：輸入用於加密磁碟區的客戶根金鑰的 CRN。若您使用的是其他帳戶的 CRK，請選擇此選項。按一下「選取」以繼續進行「依執行個體搜尋」選項中所述的「檢視」步驟。
7. 選擇儲存設定檔。如果選擇從快照匯入資料，快照的儲存產生值必須與所選卷配置文件的儲存產生值相符。
  - 已列入白名單的帳戶可選擇「sdp」配置檔，以指定最高達 32,000 GB 的儲存容量，並可自訂 IOPS 及吞吐量上限。未列入白名單的帳戶將無法看到此選項。
  - 當您想要使用具有預先定義 IOPS 層級的第一代磁碟區時，您可以選擇其中一個 _層級_設定檔。當您選擇_一般用途_、5iops-tier 或 10iops-tier 時，您只需指定容量。
  - 當您的應用程式效能需求不屬於任何 IOPS 層級時，您可以選擇_自訂_設定檔。指定您的磁碟區大小，以及磁碟區容量適當範圍內的 IOPS。卷大小可以是 10 - 16,000 GB。當您鍵入 IOPS 值時，使用者介面會顯示可接受的範圍。您也可以按一下儲存大小連結，查看自訂磁碟區設定檔的大小和 IOPS 範圍。
8. 您可以在建立磁碟區時套用備份原則。按一下套用，然後從側面板的下拉清單中選擇現有政策。選擇要套用到目標的標籤，然後按一下套用原則和標籤。
9. 按一下儲存。
您會傳回虛擬執行個體設定頁面以完成虛擬伺服器執行個體的其餘屬性的定義。
當您對自己的選擇感到滿意時，請點擊建立虛擬伺服器。

一個 Block Storage for VPC 卷一次只能掛載到一台虛擬伺服器上。在「Block Storage for VPC」卷宗摘要頁面上，您可以透過選取「已連接的實例」下的實例名稱，來查看該虛擬伺服器實例的詳細資訊。

從現有實例建立並連接 Block Storage for VPC 磁區

您可以從現有實例建立 Block Storage for VPC 磁區。

前往虛擬伺服器實例清單。在 IBM Cloud控制台中，點選導航選單圖示> 基礎架構> 計算 > 虛擬伺服器實例。
請從清單中選取一個實例。
在實例詳細資訊頁面上，按一下儲存索引標籤。
在連接的儲存磁碟區清單中，按一下附加。
在側邊畫面中，按一下 區塊磁區 下的向下箭頭，然後選取 建立資料磁區。側邊畫面會擴充欄位，以定義磁區。
1. 如果您先前已建立磁區 Snapshot，則匯入磁區 Snapshot 的選項會變成可用。按一下切換至從快照匯入，然後從清單中選擇一個快照或透過其 CRN 找到該快照。
2. 請為您的磁碟區指定一個唯一且具意義的名稱。例如，這可以是一個能描述您的運算或工作負載功能的名稱。卷名必須以小寫字母開頭。名稱最多可包含 63 個小寫字母數字字元，並包含連字號 (-)。磁碟區名稱對於您的 VPC 必須是唯一的。如果您願意，稍後可以編輯這個名稱。
3. 「自動刪除」功能預設為停用狀態。如果您希望在刪除附加的虛擬伺服器執行個體時刪除該卷，請按一下切換開關以啟用該功能。
4. 資源組和位置繼承自實例。這些值無法變更。
5. 您可以指定與此磁碟區關聯的選用使用者標籤。如需使用使用者標籤來組織資源的相關資訊，請參閱使用標籤。
6. 在「加密」區段中，預設已啟用由供應商管理的加密功能。若要使用您自己的加密金鑰，請點擊切換按鈕以啟用客戶自管加密功能。如果您已經擁有 KMS 實例和根金鑰，系統會自動為您選取該實例。您可以點擊「編輯圖示 」以切換至其他金鑰或執行個體。若要找到您的加密金鑰，請選擇以下選項之一：
  - 依執行個體搜尋：此面板包含三個步驟：
    1. 選擇 KMS 執行個體：此清單顯示每個可用 Key Protect 執行個體的名稱、ID、類型（標準型或專用型）以及位置。選取一個執行個體，然後按一下「選取」。如果您還沒有實例，請點擊「建立」以配置一個。
    2. 關聯金鑰：此清單顯示每個可用根金鑰的名稱、ID、最後更新日期、別名及金鑰圈。選擇一個鍵，然後按一下「選取」。如果您還沒有金鑰，請點擊「建立新金鑰」。
    3. 檢視：請確認您的選項，包括金鑰管理服務、執行個體類型、執行個體名稱及金鑰名稱。「服務授權」區段會顯示 Block Storage for VPC 與 KMS 執行個體之間是否已建立所需的授權關係。若非如此，您可以讓 Key Protect 自動建立授權，或手動建立一個。如需更多資訊，請參閱《為 Block Storage for VPC 建立服務對服務授權》。按下「確認」以套用您的選項，並返回磁碟區設定畫面。
  - 透過 CRN 定位：輸入用於加密磁碟區的客戶根金鑰的 CRN。若您使用的是其他帳戶的 CRK，請選擇此選項。按一下「選取」以繼續進行「依執行個體搜尋」選項中所述的「檢視」步驟。
7. 按下一步。
8. 選擇儲存設定檔。如果選擇從快照匯入資料，快照的儲存產生值必須與所選卷配置文件的儲存產生值相符。
  - 已列入白名單的帳戶可選擇「sdp」設定檔。然後，指定磁碟區的容量、所需的頻寬限制和所需的 IOPS。磁碟區大小可從 1 - 32,000 GB 不等。您可以在 100 - 64,000 的範圍內指定 IOPS。吞吐量限制範圍為 1000-8192 Mbps。未列入白名單的帳戶將無法看到此選項。
  - 您可以選擇其中一個 _分層_設定檔。選擇_一般用途_後、5iops-tier 或 10iops-tier 之後，下一步就是指定儲存容量。卷大小可以是 10 - 16,000 GB。
  - 如果您的應用程式效能需求不屬於任何 IOPS 層級，您可以選擇_自訂_設定檔。然後，指定磁碟區的大小，並根據磁碟區容量在適當的範圍內指定 IOPS。卷大小可以是 10 - 16,000 GB。當您鍵入 IOPS 值時，使用者介面會顯示可接受的範圍。您也可以按一下儲存大小連結，查看自訂磁碟區設定檔的大小和 IOPS 範圍。
9. 按一下儲存。
當您完成定義磁區時，請按一下儲存。此儲存體已建立並附加至該執行個體。您會回到實例詳細資料頁面。新的磁區會顯示在儲存磁區清單中。

建立獨立式 Block Storage for VPC 磁區

您可以建立一個獨立於虛擬伺服器配置的「Block Storage for VPC」儲存卷，並在稍後將該儲存卷掛載至實例上。

在 IBM Cloud控制台中，按一下導航選單圖示> 基礎架構> 儲存 >Block Storage區。
按一下建立。
上Block Storage for VPC配置頁面，查看地點資訊。地理、區域和可用區繼承自 VPC（例如，北美、達拉斯、Dallas-1 ）。您可以從選單中選擇您所在位置的不同區域，方法是點擊編輯圖示。
在裡面細節部分，您必須指定磁碟區的名稱以及該磁碟區要新增的資源群組。您可以選擇性地新增使用者及存取管理標籤。
1. 為您的磁區指定有意義的名稱。例如，提供一個說明運算或工作負載函數的名稱。
  
  卷名必須以小寫字母開頭。卷名最多可包含 63 個小寫字母數字字符，並包含連字符 (-)。磁碟區名稱在整個 VPC 基礎設施中必須是唯一的。您可以稍後編輯名稱。
2. 指定資源群組。
3. 指定使用者標籤以組織資源並供備份原則使用。
4. 指定在 IAM 中建立的存取管理標籤，以協助您管理對磁區的存取權。
在裡面可選配置部分，您可以指定是否要使用快照中的資料建立磁碟區。有關更多信息，請參閱創建一個獨立的Block Storage for VPC快照中的捲。此外，您也可以選擇套用備份策略。點擊「套用」以查看可選的保單與方案。
在設定檔部分，您可以指定磁碟區的效能設定檔、效能限制和容量。如果您選擇從快照匯入資料，快照的儲存產生值必須與所選卷配置文件的儲存產生值相符。
- 已列入白名單的帳戶可選擇「sdp」設定檔。然後，指定磁碟區的容量、要求的吞吐量限制和所需的 IOPS。磁碟區大小可從 1 - 32,000 GB 不等。您可以在 100 - 64,000 的範圍內指定 IOPS。吞吐量限制範圍為 1000-8192 Mbps。未列入白名單的帳戶將無法看到此選項。
- 您可以選擇其中一個 _分層_設定檔。選擇_一般用途_後、5iops-tier 或 10iops-tier 之後，下一步就是指定儲存容量。卷大小可以是 10 - 16,000 GB。
- 如果您的應用程式效能需求不屬於任何 IOPS 層級，您可以選擇_自訂_設定檔。然後，指定磁碟區的大小，並根據磁碟區容量在適當的範圍內指定 IOPS。當您鍵入 IOPS 值時，使用者介面會顯示可接受的範圍。您也可以按一下儲存大小連結，查看自訂磁碟區設定檔的大小和 IOPS 範圍。
在「靜態加密」區段中，您可以選擇繼續使用由 IBM 管理的金鑰進行加密，此功能預設已啟用於所有磁碟區。或者，您也可以選擇使用自己的加密金鑰。若要變更金鑰或執行個體，請按一下「編輯」圖示 ，以開啟「設定加密」側邊面板。請從以下選項中選擇一項，以查找您的加密金鑰：
- 依執行個體搜尋：此面板包含三個步驟：
  1. 選擇 KMS 執行個體：此清單顯示每個可用 Key Protect 執行個體的名稱、ID、類型（標準型或專用型）以及位置。選取一個執行個體，然後按一下「選取」。如果您還沒有實例，請點擊「建立」以配置一個。
  2. 關聯金鑰：此清單顯示每個可用根金鑰的名稱、ID、最後更新日期、別名及金鑰圈。選擇一個鍵，然後按一下「選取」。如果您還沒有金鑰，請點擊「建立新金鑰」。
  3. 檢視：請確認您的選項，包括金鑰管理服務、執行個體類型、執行個體名稱及金鑰名稱。「服務授權」區段會顯示 Block Storage for VPC 與 KMS 執行個體之間是否已建立所需的授權關係。若非如此，您可以讓 Key Protect 自動建立授權，或手動建立一個。如需更多資訊，請參閱《為 Block Storage for VPC 建立服務對服務授權》。按下「確認」以套用您的選項，並返回磁碟區配置頁面。
- 透過 CRN 定位：輸入用於加密磁碟區的客戶根金鑰的 CRN。若您使用的是其他帳戶的 CRK，請選擇此選項。按一下「選取」以繼續進行「依執行個體搜尋」選項中所述的「檢視」步驟。
如果您選擇第二代快照來建立磁碟區，您的磁碟區加密類型必須與快照的加密類型相符。如果快照有提供者管理的金鑰，請勿指定來自金鑰管理服務的金鑰。
完成後，按一下建立區塊儲存卷。
- 如果您尚未準備好訂購，或只是在尋找定價資訊，則可以將您在側邊畫面中看到的資訊新增至「預估」。有關此功能如何工作的更多信息，請參閱估算您的成本。
您將返回到Block Storage for VPC卷頁面，其中有一條訊息指示正在建立磁碟區（磁碟區狀態為_待辦的_）。建立磁碟區時會顯示第二條訊息（磁碟區狀態為_可用的_）。
若要檢視新磁區的詳細資料，請選取第二則訊息中的檢視資源鏈結，以移至「磁區詳細資料」頁面。

當您在控制台中重新整理「Block Storage」卷宗清單時，新卷宗會出現在卷宗清單的開頭。對於獨立卷，附件類型列為空 (-)。這行動選單在表格行的末尾提供了一個鏈接附上一個Block Storage實例的磁碟區。

創建一個獨立的Block Storage for VPC控制台中快照的捲

當您建立 Block Storage for VPC 磁區時，您可以選取 Snapshot 並使用其資料來建立新磁區。呈現的 Snapshot 處於穩定狀態。從 Snapshot 建立的資料磁區未連接至實例，並出現在 Block Storage for VPC 磁區清單中。您稍後可以將此儲存卷掛載到實例上。

您可以從「可開機」Snapshot 還原開機磁區。當您建立虛擬伺服器實例時，會還原開機磁區。

在 IBM Cloud控制台中，按一下導航選單圖示> 基礎架構> 儲存 >Block Storage區。
選取建立。
指定磁碟區的位置、磁碟區名稱、可選的資源群組和標籤。
在裡面可選配置部分，點擊從快照匯入。請從以下選項中選擇一項
- 按一下匯入現有快照以查看可用快照的清單。所呈現的所有快照均處於_穩定_狀態。預設情況下，選擇 “不可啟動” 選項卡，其中列出了所有資料卷快照。若要恢復啟動卷，請按一下 「可啟動」 標籤。預設會選擇將磁碟區附加到新的虛擬伺服器執行個體。建立實例時，會還原開機磁區。
- 按一下按 CRN 匯入快照並提供要使用的快照的 CRN。
按一下儲存。磁區供應頁面上會顯示 Snapshot 的相關資訊，包括名稱、其大小、建立日期、其來源磁區，以及它是否為可啟動 Snapshot。可啟動 Snapshot 資訊包括作業系統及映像檔。加密繼承自 Snapshot，並顯示在加密區段中。
按一下「建立區塊儲存卷」。

第一代和第二代音量剖面不能互換。您可以使用第二代磁碟區的快照來建立另一個第二代磁碟區，但不能將磁碟區設定檔切換為第一代磁碟區設定檔。同樣地，您可以使用第一代磁碟區的快照，以相同的資料建立另一個第一代磁碟區，而且不能將新的磁碟區切換到 sdp 設定檔。

當您重新整理 Block Storage for VPC 的「卷」頁面時，新卷會出現在卷清單的最前面。如果已順利建立磁區，它會顯示「可用」狀態。對於獨立式磁區，「連接類型」直欄為空白 (-)。位於表格列尾端的動作功能表提供鏈結，可將 Block Storage for VPC 磁區連接至實例。

從 CLI 建立 Block Storage for VPC 磁區

您可以使用指令行介面 (CLI) 來建立 Block Storage for VPC 磁區。

開始之前

在使用 CLI 之前，您必須先安裝「IBM Cloud」CLI 以及 VPC CLI 外掛程式。如需相關資訊，請參閱 CLI 必要條件。

請登入 IBM Cloud。
```
ibmcloud login --sso -a cloud.ibm.com
```
此指令會傳回 URL 並提示輸入密碼。在瀏覽器中移至該 URL 並登入。如果成功，您將獲得一次性密碼。複製此密碼並將其作為回應貼上到提示上。成功鑑別之後，系統會提示您選擇帳戶。如果您擁有多個帳戶，請選擇您要登入的帳戶。回應任何剩餘提示以完成登入。

從 CLI 建立 Block Storage for VPC 磁區

執行以下指令以建立一個 Block Storage for VPC 磁碟區。提供磁區名稱、設定檔名稱和地區中可用性區域的名稱。如需 Block Storage for VPC 設定檔的相關資訊，請參閱設定檔。額外選項顯示在方括弧中。

有效的磁碟區名稱可以包含小寫字母、數字（a-z、0-9）以及連字號（-）的組合，長度最多為 63 個字元。卷名必須以小寫字母開頭。磁區名稱在整個 VPC 基礎架構中必須是唯一的。例如，如果您在相同帳戶和地區中建立兩個同名磁區，則會觸發 volume name duplicate 錯誤。

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--json]

請參閱下列範例。

ibmcloud is volume-create demovolume1 custom us-east-1 --capacity 500 --iops 3000 --tags env:test,env:prod

Creating volume demovolume1 in resource group Default under account Test Account as user test.user@ibm.com...
ID                                     r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Name                                   demovolume1
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Status                                 pending
Attachment state                       unattached
Capacity                               500
IOPS                                   3000
Bandwidth(Mbps)                        6291
Profile                                custom
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-07-24T16:20:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   env:test,env:prod
Storage Generation                     1

容量以兆位元組為單位，範圍可從 10 至 16,000 GB。如果未指定，預設容量為 100 GB。 IOPS 值可以是 100-48,000 IOPS，視設定檔和磁區大小而定。如果未指定，IOPS 值會根據磁區設定檔預設為有效配置。如需相關資訊，請參閱自訂 IOPS 的表格。

磁區名稱最多可以為 63 個小寫英數字元，並包含連字號 (-)，且必須以小寫字母開頭。磁區名稱在整個 VPC 基礎架構中必須是唯一的。

記下磁區 ID。當您將 Block Storage for VPC 附加至虛擬伺服器實例、檢視 Block Storage for VPC 磁碟區詳細資訊，或刪除磁碟區時，必須指定該 ID。

當磁區狀態為 pending 時，磁區性能狀態會顯示 inapplicable。建立磁區之後，除非建立失敗，否則性能狀態會顯示 OK。如需相關資訊，請參閱 Block Storage for VPC 磁區性能狀態。

新增使用者標籤以識別磁區資源。當這些標籤與備份原則中的標籤相符時，會根據備份計劃中的排程來備份磁區。如需相關資訊，請參閱建立備份原則。

若要建立獨立磁碟區，請執行 ibmcloud is volume-create 指令，並指定 sdp 設定檔，以及磁碟區的大小和效能需求。以下範例在 us-east 區域建立容量為 200 MB、IOPS 為 100 的資料卷。

ibmcloud is volume-create defined-performance-vol sdp us-east-3 --capacity 200 --iops 3000 --bandwidth 2000

Creating volume defined-performance-vol under account Test Account as user test.user@ibm.com...
ID                                     r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Name                                   defined-performance-vol
CRN                                    crn:v1:bluemix:public:is:us-east-3:a/a1234567::volume:r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Status                                 pending
Attachment state                       unattached
Capacity                               200
IOPS                                   3000
Bandwidth(Mbps)                        2000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-03-25T09:59:26+05:30
Zone                                   us-east-3
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Adjustable IOPS                        true
Busy                                   false
Tags                                   -
Storage Generation                     2

從 CLI 建立具有客戶管理加密的獨立式 Block Storage for VPC 磁區

若要透過 CLI 建立具備客戶管理加密功能的 Block Storage 儲存區，請使用 ibmcloud is volume-create 指令並搭配 --encryption-key 選項。 encryption_key 選項需要為金鑰管理服務中的根金鑰提供有效的 CRN。

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--encryption-key ENCRYPTION_KEY] [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON]

下列範例顯示具有自訂 IOPS 的磁區，以及使用客戶管理的加密所建立的容量。

ibmcloud is volume-create demo-cli-volume custom us-east-1 --capacity 300 --iops 1500 --encryption-key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9

Creating volume demo-cli-volume under account Test Account as user test.user@ibm.com...
ID                                     r014-3984600c-6f4d-4940-82de-519a867fa3c0
Name                                   demo-cli-volume
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-3984600c-6f4d-4940-82de-519a867fa3c0
Status                                 pending
Attachment state                       unattached
Capacity                               300
IOPS                                   1500
Bandwidth(Mbps)                        3145
Profile                                custom
Encryption key                         crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Encryption                             user_managed
Resource group                         defaults
Created                                2023-06-29T20:10:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

從 CLI 從 Snapshot 建立獨立式 Block Storage for VPC 磁區

執行 ibmcloud is volume-create 命令並指定 --snapshot 選項以及用於建立新磁碟區的快照的名稱、ID 或 CRN。磁區已取消連接，如回應中的連接狀態所指示。

此範例會從名稱指定的 Snapshot 建立新磁區。

ibmcloud is volume-create volume-4 general-purpose us-south-1 --snapshot r006-4602b3de-3885-4b49-8d46-65aacb72a1d6

Creating volume volume-4 under account Test Account as user test.user@ibm.com...
ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   volume-4
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 pending
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

如需相關資訊，請參閱 CLI 參考資料中的 ibmcloud is volume-create。

建立資料磁區作為現有虛擬伺服器實例的連接

您可以使用 instance-volume-attachment-add 指令來建立磁區，並將它連接至實例。下列範例會建立具有 custom 設定檔、100 GB 容量及 100 IOPS 的磁區。

ibmcloud is instance-volume-attachment-add acd-vol-attach1 my-instance-1 --profile custom --new-volume-name acd-vol-2 --iops 100 --capacity 100

Creating volume attachment acd-vol-attach1 for instance my-instance-1 under account Test Account as user test.user@ibm.com...
ID                730f-5f63eb4d-2683-4dd6-a20a-5ab06b4061c6
Name              acd-vol-attach1
Volume            -
Status            attaching
Bandwidth(Mbps)   14
Type              data
Device            -
Auto delete       false
Created           2023-05-05T07:42:33+05:30

如需相關資訊，請參閱 CLI 參考資料中的 ibmcloud is instance-volume-attachment-add。

從 CLI 建立具有 `sdp` 磁碟區的實體

若要建立虛擬伺服器實體，請執行 ibmcloud is instance-create 指令，並指定實體的詳細資訊和要附加的磁碟區的詳細資訊。以下範例會建立一個具有 sdp 開機磁碟區的虛擬伺服器實例，並同時附加 sdp 資料磁碟區。

ibmcloud is instance-create my-defined-performance-instance test-vpc us-east-3 bx2-2x8 csi-subnet-cidr-3b6k-storage-v5lvug8w-380sal --boot-volume '{"name": "boot-vol-attachment-name-instance-1", "volume": {"name": "boot-vol-name-1", "profile": {"name": "sdp"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach '[{"volume": {"capacity": 1000,"iops": 32000,"bandwidth": 3000,"name": "my-data-volume-1","profile": {"name": "sdp"}}}]' --image r006-5f183c60-78a0-4d6e-9be5-84335939255a

Creating instance my-defined-performance instance under account Test Account as user test.user@ibm.com...
ID                                    730f_59883a41-c943-423c-a6ab-e2b066f2f314
Name                                  my-defined-performance-instance
CRN                                   crn:v1:bluemix:public:is:us-east-3:a/a1234567::instance:730f_59883a41-c943-423c-a6ab-e2b066f2f314
Status                                pending
Availability policy on host failure   restart
Startable                             true
Profile                               bx2-2x8
Architecture                          amd64
vCPU Manufacturer                     intel
vCPUs                                 2
Memory(GiB)                           8
Bandwidth(Mbps)                       4000
Volume bandwidth(Mbps)                1000
Network bandwidth(Mbps)               3000
Lifecycle Reasons                     Code   Message
                                      -      -
Lifecycle State                       pending
Metadata service                      Enabled   Protocol   Response hop limit
                                      false     http       1
Image                                 ID                                          Name
                                      r006-5f183c60-78a0-4d6e-9be5-84335939255a   embolism-lapped-overjoyed-bagel-elated
VPC                                   ID                                          Name
                                      r006-be9d04ab-d10c-4be7-9de6-95cd2208d1de   test-vpc-do-not-delete-default
Zone                                  us-east-3
Resource group                        ID                                 Name
                                      85cbbee12af748eabb6513cf311d4e2d   Default
Created                               2024-09-24T02:01:10+05:30
Boot volume                           ID   Name   Attachment ID                               Attachment name
                                      -    -      730f-e4d7ce78-011e-4dd1-8752-3ceb12bce79f   boot-vol-attachment-name-instance-1
Data volumes                          ID   Name   Attachment ID                               Attachment name
                                      -    -      730f-78f2db0a-57df-4b5f-9f1e-f800e91e89af   upscale-embargo-oops-overeager

如需詳細資訊，請參閱 CLI 參考資料中的 ibmcloud is instance-create。

從 CLI 建立實例並將使用者標籤新增至磁區

您可以在建立虛擬伺服器實例時指定開機及資料磁區的使用者標籤。執行 instance-create 指令，並在 user_tags 選項中指定使用者標籤。您也可以稍後編輯標籤，或將更多標籤新增至指定的磁區。如需相關資訊，請參閱 VPC CLI 參考資料。

在範例指令中，

開機磁區由指定使用者標籤 env:test4 和 env:dev4 的 --boot-volume 選項定義。
資料磁區連接由 --volume-attach 選項定義，並指定相同的使用者標籤。

建立實例之後，當您查看開機或資料磁區的詳細資料時，可以看到使用者標籤。

ibmcloud is instance-create my-vsi-4 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-4", "volume": {"name": "my-boot-vol-4", "profile": {"name": "general-purpose"},"user_tags": ["env:test4", "env:dev4"]}}' --volume-attach  '[{"name": "my-vol-att1", "volume": {"name":"my-vol-4", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test4", "env:dev4"]}}]'

Creating instance my-vsi-4 under account vpcdemo1 as user myuser@mycompany.com...
ID                                    efd06503-f514-4ea2-ba6c-2b9c715e6269
Name                                  my-vsi-4
CRN                                   crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:efd06503-f514-4ea2-ba6c-2b9c715e6269
Status                                pending
Availability policy on host failure   restart
Startable                             true
Profile                               bx2-2x8
Architecture                          amd64
vCPUs                                 2
Memory(GiB)                           8
Bandwidth(Mbps)                       4000
Volume bandwidth(Mbps)                1000
Network bandwidth(Mbps)               3000
Metadata service                      Enabled
                                      false
Image                                 ID                                          Name
                                      r006-c5471ef3-15f5-4468-964b-f9b4d3ca8120   ibm-centos-7-9-minimal-amd64-6
VPC                                   ID                                          Name
                                      r006-dd1c6831-cc4d-4c40-aab2-6b0c17f41424   my-vpc-2
Zone                                  us-south-1
Resource group                        ID                                 Name
                                      bdd96715c2a44f2bb60df4ff14a543f5   Default
Created                               2022-08-09T09:25:06+05:30
Boot volume                           ID   Name   Attachment ID                               Attachment name
                                      -    -      r006-1bcf5342-c12f-4908-ad0f-99218cd603b9   boot-vol-4
Data volumes                          ID   Name   Attachment ID                               Attachment name
                                      -    -      r006-c034f0f9-2269-44e4-a76a-4f4ad8c47b65   my-vol-att1

從 CLI 建立實例範本並將使用者標籤新增至磁區

您可以在建立實例時指定開機及資料磁區的使用者標籤。執行 instance-template-create 指令，並在 user_tags 參數中指定使用者標籤。

在下列範例中，指令會將兩個使用者標籤新增至要套用至磁區的實例範本。

ibmcloud is instance-template-create my-tpl-1 my-vpc-2 us-south-1 bx2-2x8 cli-subnet-1 --image ibm-centos-7-9-minimal-amd64-6 --keys my-keys4 --boot-volume '{"name": "boot-vol-1", "volume": {"name": "my-boot-vol-1", "profile": {"name": "general-purpose"},"user_tags": ["env:test1", "env:dev1"]}}' --volume-attach  '[{"name": "my-vol-att", "volume": {"name":"my-vol-1", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test1", "env:dev1"] }}]'

Creating instance template my-tpl-1 under account vpcdemo as user myuser@mycompany.com...
ID                          38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Name                        my-tpl-1
CRN                         crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance-template:38ef87e9-3a4d-4d72-8450-86c16b76ae0d
Resource group              Default
Image                       c5471ef3-15f5-4468-964b-f9b4d3ca8120
VPC                         dd1c6831-cc4d-4c40-aab2-6b0c17f41424
Zone                        us-south-1
Profile                     bx2-2x8
Metadata service            Enabled
                            false
Keys                        Key IDs
                            e7d18039-0e0e-4207-8598-de7cca949030
Boot volume                 Name            Capacity   Profile           IOPS   Attachment name   Auto delete   Tags
                            my-boot-vol-1   100        general-purpose   0      boot-vol-1     true          env:test1,env:dev1
Data volumes                ID   Name       Capacity   Profile           IOPS   Attachment name   Auto delete   Tags
                            -    my-vol-1   10         general-purpose   0      my-vol-att        false         env:test1,env:dev1
Primary Network Interface   Name      Subnet ID                                   Security Groups                             Allow source IP spoofing   Reserved IP Address   Reserved IP ID   Reserved IP Name   Reserved IP Auto Delete
                            primary   0617-c1f1e468-3283-4f44-9d08-3d57b77817f1   7c2db5ac-19e0-4d83-8226-e6178fedfe56   false                      -                     -                -                  -
Created                     2022-08-22T09:10:34+05:30

您可以使用實例範本來建立實例，並使用使用者標籤來建立卷冊。請參閱下列範例。

ibmcloud is instance-template-create --template my-tpl-1 --name my-vsi-3 --boot-volume '{"name": "boot-vol-3", "volume": {"name": "my-boot-vol-3", "profile": {"name": "general-purpose"},"user_tags": ["env:test3", "env:dev3"]}}' --volume-attach  '[{"name": "my-vol-att1", "volume": {"name":"my-vol-3", "profile": {"name": "general-purpose"}, "capacity": 10,"user_tags": ["env:test3", "env:dev3"] }}]'

使用 API 建立 Block Storage for VPC 磁區

您可以直接呼叫 VPC REST API來建立 Block Storage for VPC 磁區。如需檔案共用 VPC API 的相關資訊，請參閱 VPC API 參考資料。

開始之前

定義 IAM 記號、API 端點和 API 版本的變數。如需指示，請參閱設定 API 和 CLI 環境。

在使用 API 佈建實例的過程中建立資料磁區

提出 POST /instances 要求以建立實例，並使用 volume_attachments 參數來定義磁區。指定磁區名稱、容量及設定檔。

此範例指定開機及資料磁區的客戶管理加密及使用者標籤。

curl -X POST "$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-boot-volume",
      "profile": {"name": "general-purpose"},
      "storage_generation": 1,
      "user_tags": {"env:test","env:prod"}}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
  "name": "my-instance",
  "placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
  "profile": {"name": "bx2-2x8"},
  "volume_attachments": [
    {"volume": {
        "capacity": 1000,
        "encryption_key": {"crn": "crn:[...]"},
        "name": "my-data-volume",
        "profile": {"name": "5iops-tier"},
        "storage_generation": 1,
        "user_tags": {"env:test","env:prod"}}
    }],
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-south-1"}
}'

成功回應類似下列內容：

{
  "bandwidth": 4000,
  "boot_volume_attachment": {
    "device": {
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
    "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
    "name": "my-boot-volume-attachment",
    "volume": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
      "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
      "name": "my-boot-volume"
    }
  },
  "created_at": "2022-06-15T16:11:57Z",
  "crn": "crn:[...]",
  "dedicated_host": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "disks": [],
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "id": "eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "name": "my-image"
  },
  "memory": 8,
  "name": "my-instance",
  "network_interfaces": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "name": "my-network-interface",
      "primary_ipv4_address": "10.0.0.32",
      "resource_type": "network_interface",
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/7389-bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "name": "my-subnet"
      }
    }
  ],
  "placement_target": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "primary_network_interface": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "name": "my-network-interface",
    "primary_ipv4_address": "10.0.0.32",
    "resource_type": "network_interface",
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "name": "my-subnet"
    }
  },
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instance/profiles/bx2-2x8",
    "name": "bx2-2x8"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "running",
  "status_reasons": [],
  "vcpu": {
    "architecture": "amd64",
    "count": 2
  },
  "volume_attachments": [
    {
      "device": {
        "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
      "name": "my-boot-volume-attachment",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
        "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
        "name": "my-boot-volume"
      }
    },
    {
      "device": {
        "id": "e77125cb-4df0-4988-a878-531ae0ae0b70"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-e77125cb-4df0-4988-a878-531ae0ae0b70",
      "id": "e77125cb-4df0-4988-a878-531ae0ae0b70",
      "name": "my-volume-attachment-1",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "id": "2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "name": "my-data-volume"
      }
    }
  ],
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "name": "my-vpc"
  },
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

使用 API 建立 `sdp` 開機磁碟區作為實體佈建的一部分

除了容量和 IOPS，您也可以使用 bandwidth 屬性指定自訂吞吐量限制。請參閱下列範例。

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-09-24&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-defined-performance-boot-volume",
      "profile": {"name": "sdp"},
      "boot_capacity": 250,
      "iops": 3000,
      "bandwidth": 1000
      "storage_generation": 2,
      "user_tags": {"env:test","env:prod"}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
  "name": "my-instance",
  "placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
  "profile": {"name": "bx3dc-2x10"},
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-east-1"}
  }
}

如需更多關於使用 API 建立磁碟區的資訊，請參閱建立 Block Storage 磁碟區，以及建立實例的 API 參考

使用 API 建立獨立式 Block Storage for VPC 磁區

提出 POST /volumes 要求以建立磁區。指定名稱、IOPS、容量、設定檔及區域。

下列範例在 us-south 區域中建立了具有 50 MB 容量及 100 IOPS 的 custom 磁區。要求也會指定客戶管理的加密和資源群組的客戶根金鑰。

curl -X POST "$vpc_api_endpoint/v1/volumes?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4",
      "iops": 100,
      "capacity": 50,
      "zone": {"name": "us-south-2"},
      "profile": {"name": "custom"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

成功的回應如下例所示。

{
  "capacity": 50,
  "created_at": "2022-06-14T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

使用 sdp 設定檔時，您可以建立具有自訂容量和 IOPS 的資料卷，也可以使用 bandwidth 屬性指定自訂吞吐量限制。以下範例在 us-east 區域建立這樣的獨立資料卷。

curl -X POST "$vpc_api_endpoint/v2/volumes?version=2024-09-27&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-special-volume-1",
      "iops": 3000,
      "capacity": 250,
      "bandwidth": 5000,
      "zone": {"name": "us-east-2"},
      "profile": {"name": "sdp"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

成功的回應如下例所示。

{
  "adjustable_capacity_states:": "attached, unattached",
  "adjustable_iops_states": "attached, unattached",
  "bandwidth": 5000,
  "capacity": 250,
  "created_at": "2024-09-27T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-east.iaas.cloud.ibm.com/v2/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 3000,
  "name": "my-special-volume-1",
  "profile": {
    "href": "https://us-east.iaas.cloud.ibm.com/v2/volume/profiles/sdp",
    "name": "sdp"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2",
    "name": "us-east-2"
  }
}

如需使用 API 建立磁區的相關資訊，請參閱建立 Block Storage 磁區，以及建立磁區的 API 參考資料。

使用 API 從快照建立資料卷

您可以在 POST /volumes 呼叫中指定快照 ID、名稱或 CRN 以建立獨立資料磁碟區。當您指定 storage_generation 屬性值為 1 的快照時，會以相同的 storage_generation 值建立新的區塊儲存磁碟區，且只能套用相同世代的磁碟區配置文件。

當您將資料磁區連接至虛擬伺服器實例時，會完全還原資料。有關更多信息，請參閱關於從快照恢復磁碟區。有關 API 呼叫的範例，請參閱從未附加磁碟區的快照還原資料卷。

使用 Terraform 建立 Block Storage for VPC 磁區

要使用 Terraform，請下載 Terraform CLI 並配置 IBM Cloud® Provider 外掛程式。如需相關資訊，請參閱 Terraform 入門。

VPC 基礎架構服務使用特定的地區端點，依預設會以 us-south 為目標。如果您的 VPC 建立在另一個地區中，請確保將 provider.tf 檔案中提供者區塊中的適當地區設為目標。

請參閱下列以非預設 us-south 地區為目標的範例。

provider "ibm" {
   region = "eu-de"
}

使用 Terraform 建立獨立式 Block Storage for VPC 磁區

若要建立 Block Storage for VPC 磁區，請使用 ibm_is_volume 資源。以下範例建立第一代磁碟區，容量為 4 TB，效能設定檔為 10iops-tier。

resource "ibm_is_volume" "10iops_volume_example" {
  name     = "example-volume-10iops"
  profile  = "10iops-tier"
  zone     = "us-south-1"
  capacity = 4000
}

以下範例以 custom 設定檔建立第一代磁碟區。所建立的磁區具有 200 MB 容量，並且可以執行 1000 IOPS。

resource "ibm_is_volume" "custom_volume_example" {
  name           = "example-volume-custom"
  profile        = "custom"
  zone           = "us-south-1"
  iops           = 1000
  capacity       = 200
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

以下範例使用 sdp 設定檔建立第二代磁碟區。建立的磁碟區容量為 250 MB，可執行 3000 IOPS，最大頻寬限制為 1000 Mbps。

resource "ibm_is_volume" "sdp_volume_example" {
  name           = "example-volume-sdp"
  profile        = "sdp"
  zone           = "us-south-1"
  iops           = 3000
  capacity       = 250
  bandwidth      = 1000
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

如需引數及屬性的相關資訊，請參閱 ibm_is_volume。

使用 Terraform 從 Snapshot 建立獨立式 Block Storage for VPC 磁區

若要從 Snapshot 建立 Block Storage for VPC 磁區，請使用 ibm_is_volume 資源。下列範例會根據其 ID 所識別的 Snapshot 來建立磁區。您也可以使用名稱或 CRN 來識別快照。

resource "ibm_is_volume" "example-volume-from-snapshot" {
  name            = "example-volume"
  profile         = "general-purpose"
  zone            = "us-south-1"
  source_snapshot = ibm_is_snapshot.example.id
}

如需引數及屬性的相關資訊，請參閱 ibm_is_volume。

使用 Terraform 建立開機磁碟區作為實體佈建的一部分

若要在建立虛擬伺服器實例時從 Snapshot 建立資料磁區，請使用 ibm_is_instance 資源。以下範例會建立一個虛擬伺服器實例，該實例的開機磁碟區使用 sdp 磁碟區設定檔，並由客戶管理的加密金鑰保護。為開機磁碟區指定 sdp 設定檔時，您可以指定自訂容量、IOPS 和頻寬限制。

   resource "ibm_is_instance" "example_instance" {
     name    = "example-instance-reserved-ip"
     image   = data.ibm_is_image.example_image.id
     profile = data.ibm_is_instance_profile.example_profile.name
     primary_network_interface {
       name   = "eth0"
       subnet = ibm_is_subnet.example_subnet.id
       primary_ip {
         reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
       }
     }
     network_interfaces {
       name   = "eth1"
       subnet = ibm_is_subnet.example_subnet.id
       primary_ip {
         name = "example-reserved-ip1"
         auto_delete = true
         address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
       }
     }
     vpc  = ibm_is_vpc.example_vpc.id
     zone = "us-south-1"
     keys = [ibm_is_ssh_key.example_sshkey.id]
     boot_volume {
       name           = "example-boot-volume"
       profile        = "sdp"
       size           = 250
       iops           = 3000
       bandwidth      = 1000
       encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
      }
   }

如需引數及屬性的相關資訊，請參閱 ibm_is_instance。

在使用 Terraform 佈建實例的過程中從 Snapshot 建立開機磁區

若要在建立虛擬伺服器實例時從 Snapshot 建立資料磁區，請使用 ibm_is_instance 資源。下列範例會建立名稱為 "example-vsi-restore" 的虛擬伺服器實例。開機磁區定義在 boot_volume 引數中，並具有其名稱、其來源 Snapshot 及使用者標籤。

resource "ibm_is_snapshot" "example" {
  name          = "example-snapshot"
  source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
}
resource "ibm_is_instance" "example" {
  name    = "example-vsi-restore"
  profile = "cx2-2x4"
  boot_volume {
    name     = "boot-restore"
    snapshot = ibm_is_snapshot.example.id
    tags     = ["tags-0"]
  }
  primary_network_interface {
    subnet = ibm_is_subnet.example.id
  }
  vpc  = ibm_is_vpc.example.id
  zone = "us-south-1"
  keys = [ibm_is_ssh_key.example.id]
  network_interfaces {
    subnet = ibm_is_subnet.example.id
    name   = "eth1"
  }
}

如果要從另一個帳戶的快照還原卷，可以使用 source_snapshot_crn 參數透過 CRN（而不是 ID）來識別快照。

如需引數及屬性的相關資訊，請參閱 ibm_is_instance。

使用 Terraform 建立要新增至現有實例的資料磁區

若要建立資料磁區並將它連接至虛擬伺服器實例，請使用 ibm_is_instance_volume_attachment 資源。以下範例建立一個具有 general-purpose 磁碟區設定檔的 20 MB 資料卷，並將其附加到 ibm_is_instance.example.id 實例。

rresource "ibm_is_instance_volume_attachment" "example" {
  instance = ibm_is_instance.example.id
  name                               = "example-vol-att-1"
  profile                            = "general-purpose"
  capacity                           = "20"
  delete_volume_on_attachment_delete = true
  delete_volume_on_instance_delete   = true
  volume_name                        = "example-vol-1"
}

如需引數及屬性的相關資訊，請參閱 ibm_is_instance_volume_attachment。

下一步

您可以繼續建立更多 Block Storage for VPC 卷，或管理現有的卷。

建立 Block Storage for VPC 磁區

建立 Block Storage for VPC 磁區

創造Block Storage for VPC控制台中的音量

建立實例時建立並連接 Block Storage for VPC 磁區

從現有實例建立並連接 Block Storage for VPC 磁區

建立獨立式 Block Storage for VPC 磁區

創建一個獨立的Block Storage for VPC控制台中快照的捲

從 CLI 建立 Block Storage for VPC 磁區

開始之前

從 CLI 建立 Block Storage for VPC 磁區

從 CLI 建立具有客戶管理加密的獨立式 Block Storage for VPC 磁區

從 CLI 從 Snapshot 建立獨立式 Block Storage for VPC 磁區

建立資料磁區作為現有虛擬伺服器實例的連接

從 CLI 建立具有 sdp 磁碟區的實體

從 CLI 建立實例並將使用者標籤新增至磁區

從 CLI 建立實例範本並將使用者標籤新增至磁區

使用 API 建立 Block Storage for VPC 磁區

開始之前

在使用 API 佈建實例的過程中建立資料磁區

使用 API 建立 sdp 開機磁碟區作為實體佈建的一部分

使用 API 建立獨立式 Block Storage for VPC 磁區

使用 API 從快照建立資料卷

使用 Terraform 建立 Block Storage for VPC 磁區

使用 Terraform 建立獨立式 Block Storage for VPC 磁區

使用 Terraform 從 Snapshot 建立獨立式 Block Storage for VPC 磁區

使用 Terraform 建立開機磁碟區作為實體佈建的一部分

在使用 Terraform 佈建實例的過程中從 Snapshot 建立開機磁區

使用 Terraform 建立要新增至現有實例的資料磁區

下一步

從 CLI 建立具有 `sdp` 磁碟區的實體

使用 API 建立 `sdp` 開機磁碟區作為實體佈建的一部分