檢視 Block Storage for VPC 磁區

在控制台中查看有關Block Storage for VPC卷的信息

列出所有 Block Storage for VPC 磁區，並檢視單一磁區的詳細資料。請在執行個體詳細資訊中查看附件中的 Block Storage for VPC 卷詳細資訊。檢視從 Block Storage for VPC 磁區建立的所有 Snapshot。

在控制台中查看有關所有Block Storage for VPC卷的信息

移至 Block Storage for VPC 磁區的清單。在 IBM Cloud控制台中，按一下導航選單圖示選單圖示 > 基礎架構 VPC 圖示 > 儲存 >Block Storage區。

預設情況下，Block Storage for VPC 磁碟區會以 10 個為一組，顯示您區域內的所有資源群組。請點擊「頁碼控制」的下拉箭頭來變更此預設設定，並將清單數量增加至 20 或 50 卷。使用頁面控制箭頭前往下一頁或返回。在所有 Block Storage for VPC 磁區的清單中，您會看到下列資訊。

所有捲的詳細信息
欄位	說明
地區	這些磁區所在的地區，例如，美國南部。按一下向下箭頭，以查看您在其中具有帳戶的不同地區中的磁區。
名稱	按一下磁區的名稱，以查看個別磁區詳細資料。
狀態	磁區的狀態，用作所有列的預設過濾器。
位置	您所在地區中的可用性區域，繼承自 VPC（例如，美國南部 1）。
大小	您指定的磁區大小（以 GB 為單位）。
連接類型	資料（若為連接至實例的次要磁碟區）、開機（以開機磁區連接時），或空白（若為未連接的磁區）。
性能	「健康狀態」功能會監控卷的整體運作狀況，例如 I/O 效能與資料一致性。磁區性能狀態為 `OK` 或 `degraded`。處於欠佳狀態的磁區具有欠佳的效能、容量或遇到連線問題。從 Snapshot 還原的磁區也會顯示欠佳狀態。服務會顯示欠佳狀態的可能原因，讓您可以解決任何問題。如需相關資訊，請參閱 Block Storage for VPC 磁區性能狀態。
加密	依預設會在所有磁區上啟用以 IBM 管理的金鑰進行加密。您也可以在 Key Protect 實例中使用自己的根金鑰來保護您的資料。如需更多資訊，請參閱《建立採用客戶管理加密功能的 Block Storage for VPC 卷》。
標籤	套用至磁區的使用者標籤數。按一下此直欄中的數字，以檢視或編輯新視窗中的標籤。如果未將任何標籤套用至磁區，請按一下新增標籤，然後在新視窗中新增標籤。使用者標籤可以將磁區與備份原則相關聯，以建立磁區的備份。有關詳細信息，請參閱在控制台中將與備份策略關聯的使用者標籤新增至磁碟區。
動作	按一下動，顯示您可以採取的上下文特定動作功能表。

在「動作」選單（）的「卷清單」頁面中，可執行以下操作。某些操作僅在卷符號符合特定條件時才可用，例如處於已掛載或未掛載狀態。

重新命名- 重新命名此磁碟區。
連接至伺服器 — 將未連接的磁碟區連接至虛擬伺服器實例。此操作僅在卷未掛載時才可用。如需相關資訊，請參閱將磁區連接至實例。
從實例中分離 — 將已連接的儲存卷從其虛擬伺服器實例中分離。此操作僅在磁碟已掛載時才可用。如需更多資訊，請參閱「將卷從虛擬伺服器執行個體中分離」。
建立快照 — 建立此卷的快照。若此操作不可用，該選項可能會顯示為灰色。如需更多資訊，請參閱「在主控台中建立快照」。
建立映像檔 — 從啟動磁碟區建立自訂映像檔。若此操作不可用，該選項可能會顯示為灰色。如需詳細資訊，請參閱從主控台中的磁碟區建立影像。
新增標籤或 編輯標籤 — 在此卷上新增或編輯使用者標籤，並存取管理標籤。如需相關資訊，請參閱使用標籤。
刪除 — 刪除此卷。當卷已掛載至實例時，此操作會顯示為灰色且無法選取。如需詳細資訊，請參閱在主控台中刪除資料卷。
遷移卷 — 將此卷遷移至不同的設定檔或配置。如需更多資訊，請參閱「遷移區塊儲存卷」。

查看Block Storage for VPC卷的詳細信息

若要檢視「Block Storage for VPC」卷的詳細資訊，請前往所有「Block Storage for VPC」卷的清單，並選取一個卷。

磁區名稱旁邊是與此磁區相關聯的磁區狀態及標籤。用戶標籤標識資源。當使用者標籤與備份策略關聯時，它們用於建立磁碟區的備份快照。使用存取管理標籤，您可以建立彈性資源分組來管理存取權。如需這些標籤的相關資訊，請參閱使用標籤。

各卷的相關資訊

該頁面有 4 個分頁。依預設，會針對磁區詳細資料選取「概觀」標籤。

磁區詳細資料
欄位	說明
磁區詳細資料
名稱	您在建立磁碟區時所指定的磁碟區名稱。按一下編輯圖示，以編輯磁區名稱。磁區名稱最多可以為 63 個小寫英數字元，並包含連字號 (-)，且必須以小寫字母開頭。對於帳戶及區域而言，磁區名稱必須是唯一的。
磁區 ID	系統產生的磁區 ID。
性能	「健康狀態」功能會監控卷的整體運作狀況，例如 I/O 效能與資料一致性。磁區性能狀態為 `OK` 或 `degraded`。處於降級狀態的磁碟區的效能和容量不如預期，或出現連線問題。從 Snapshot 還原的磁區也會顯示欠佳狀態。服務會顯示欠佳狀態的可能原因，讓您可以解決它。如需相關資訊，請參閱 Block Storage for VPC 磁區性能狀態。
資源群組	設定 VPC 時所定義的資源群組。資源群組可管理對資源的存取，但不影響計費或監視。
連接類型	資料：若為附加至執行個體的次要磁碟區，則為「已附加」，若作為開機磁碟區附加時，則為「開機」，若為未附加的磁碟區，則為「空白」。
建立日期	建立磁區時，系統產生的日期。
位置	您所在地區中的可用性區域。
大小	您指定的磁區大小。當磁區連接至虛擬伺服器實例，且磁區未達到其範圍的容量上限時，您可以按一下圖示來擴充磁區。如需詳細資訊，請參閱擴充 Block Storage for VPC 磁碟區容量。
設定檔	此欄位顯示儲存量配置：`sdp`、自訂 IOPS，或其中一個 IOPS 層級配置檔。
IOPS 上限	預定義 IOPS 層級的最大 IOPS 值，或您為自訂 IOPS 指定的值。
傳輸量	該欄位顯示儲存磁碟區的已分配頻寬，單位為 Gigabits per second (Gbps)。吞吐量的計算方式是卷配置的 IOPS 數量乘以吞吐量乘數的結果。根據磁碟區配置文件，吞吐量乘數可以是 16 KB 或 256 KB。對於使用 `sdp` 設定檔建立的磁碟區，吞吐量值可在 1000-8192 Mbps 的範圍內自訂。
加密	依預設會在所有磁區上啟用以 IBM 管理的金鑰進行加密。您也可以使用自己的根金鑰來保護資料。「加密」欄位顯示您佈建的金鑰管理服務 (KMS) 名稱 (例如 Key Protect) 和客戶管理。如需相關資訊，請參閱使用客戶管理的加密來建立 Block Storage for VPC 磁區。
加密實例	選用。指向客戶管理的加密磁區之已佈建 KMS 實例的鏈結。
索引鍵	選用。用來加密通行詞組之根金鑰的名稱和可複製 ID，可保護客戶管理的加密磁區安全。
備份原則	與磁區相關聯的備份原則數目。按一下數字鏈結以移至備份原則標籤。
Snapshot	磁區已建立的 Snapshot 數目。按一下數字鏈結以移至 Snapshot 及備份標籤。
抄寫角色	本卷在複製關係中的角色：`source`、`replica` 或 `none`。此欄位僅適用於 `sdp` 配置檔的卷。
已連接的虛擬伺服器	這裡列出連接至虛擬伺服器實例的磁區。按一下連接，以選取要連接此磁區的實例。如需相關資訊，請參閱將磁區連接至實例。
狀態	這個欄位追蹤磁碟區的整體生命週期狀態，範圍從磁碟區建立到磁碟區刪除。例如，附加狀態在磁碟區附加到實體時為已_附加_，而在進行中時為正在_附加_。
名稱	按一下虛擬伺服器實例的名稱，以查看實例詳細資料。
自動刪除	當 _啟用_時，當您刪除實例時，會自動刪除磁區。按一下切換鍵以啟用自動刪除。
備份原則	顯示與此磁區相關聯的備份原則。若要關聯備份原則，您可以將目標資源的備份原則標籤新增至此磁區。按一下套用以選取備份原則，然後將目標資源的標籤套用至磁區。

在「動作」選單的卷宗詳細資訊頁面上，可執行以下操作：

檢視活動追蹤- 檢視此卷的活動追蹤記錄。
建立快照 — 從已掛載的資料卷或啟動卷建立快照。如需更多資訊，請參閱「在主控台中建立快照」。
建立映像檔 — 從啟動磁碟區建立自訂映像檔。當此操作不可用時，該選項會呈現灰色。如需詳細資訊，請參閱從主控台中的磁碟區建立影像。
擴充磁碟區- 以 1 GB 為單位增加已掛載磁碟區的大小。如需詳細資訊，請參閱擴充區塊儲存容量。
編輯 IOPS 設定檔 — 透過編輯 IOPS 設定檔來增加或減少 IOPS，藉此變更已連接資料卷的效能特性。
套用備份政策 — 將備份政策套用至此磁碟區。如需更多資訊，請參閱「將備份政策套用至資源」。
遷移卷 — 將此卷遷移至不同的配置檔。如需更多資訊，請參閱「遷移區塊儲存卷」。
刪除 — 刪除未掛載的磁碟區。如需詳細資訊，請參閱在主控台中刪除資料卷。

若要檢視此卷中透過手動或備份政策所建立的快照清單，請按一下「快照與備份」索引標籤。

檢視 Block Storage for VPC 磁碟區的所有快照

如果您建立了 Block Storage for VPC 開機或資料磁碟區的快照，您可以在磁碟區詳細資料頁面的第二個索引標籤上看到快照。

點選「快照與備份」索引標籤，即可查看快照清單。此清單包含以下欄位：名稱、狀態、大小、來源卷、快照副本數、建立日期（本地） 以及一致性群組。該清單還會顯示該快照是由使用者建立，還是由備份政策建立的。 Snapshot 會以降冪顯示，而最近建立的 Snapshot 會排在第一個位置。

您可以從「磁區詳細資料」頁面查看 Snapshot 的詳細資料、建立 Snapshot，以及管理 Snapshot。例如，從「動作」功能表中，您可以刪除最新 Snapshot。如需相關資訊，請參閱下列其中一個主題：

檢視與某個卷相關的所有備份政策

在磁碟區詳細資料頁面的第 3 個索引標籤上，檢視與 Block Storage for VPC 磁碟區相關的所有備份政策。會列出具有套用至此磁區之使用者標籤的所有原則。

按一下「備份原則」索引標籤。會列出具有套用至此磁區之使用者標籤的所有原則。清單提供下列資訊：

與Block Storage for VPC磁碟區關聯的備份策略。
欄位	說明
原則名稱	按一下原則名稱以移至該備份原則。
狀態	備份原則的狀態。
前次執行時間（本端）	建立該備份的備份政策最後一次預定執行時間，以當地時間顯示。

您可以按一下附加，將新的備份原則套用至此磁碟區。在側邊畫面中，從功能表中選取備份原則，然後選取要套用至磁區的原則標籤。您也可以檢視方案詳細資料，以協助您決定是否使用該原則。如果滿足，請按一下 套用原則及標籤。

當您想要將磁碟區新增至策略時，請將使用者標籤新增至目標資源的備份策略標籤中的磁碟區。當您從磁碟區移除備份原則中的標籤時，該原則將不再備份該磁碟區。

有關詳細信息，請參閱將備份策略套用至資源。

檢視批量工作

「卷宗工作」索引標籤位於卷宗詳細資訊頁面上，列出了與此卷宗相關的遷移工作。表格中的每一行提供以下資訊：

與 Block Storage for VPC 卷相關的卷工作。
欄位	說明
工作 ID	遷移工作由系統自動生成的識別碼。
工作狀態	遷移工作的當前狀態。
工作已開始	遷移工作開始的日期和時間。
工作已完成	遷移工作完成的日期和時間。

如需有關卷遷移的更多資訊，請參閱《遷移區塊儲存卷》。

檢視實例詳細資料中附加的 Block Storage for VPC 磁區詳細資料

您也可以從「虛擬伺服器」執行個體的詳細資料頁面中，檢視有關已附加的 Block Storage for VPC 卷宗的資訊：

在 IBM Cloud控制台中，按一下導航選單圖示> 基礎架構> 計算 > 虛擬伺服器實例，然後選擇實例。
在連接的區塊儲存空間磁區下，按一下磁區名稱以移至磁區詳細資料頁面。

從 CLI 檢視 Block Storage for VPC 磁區

從 CLI 檢視 Block Storage for VPC 磁區的詳細資料或所有磁區的摘要資訊。

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

從 CLI 檢視所有磁碟區

執行以下指令，以列出所有磁卷的摘要資訊：

ibmcloud is volumes [--json]

指定資源群組 ID 或名稱，會過濾屬於資源群組之磁區的清單。若省略此參數，預設值為所有資源群組。您也可以檢視特定可用性區域中的所有磁區。依預設，每頁顯示前 25 個磁區。

下列範例顯示可用性區域中所有資源群組的所有磁區。

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

如需可用指令選項的相關資訊，請參閱 ibmcloud is volumes。

從 CLI 檢視磁碟區的詳細資訊

執行下列指令以顯示特定磁碟區的詳細資訊。您可以使用磁碟區的名稱或 ID 來識別磁碟區。

ibmcloud is volume VOLUME_ID [--json]

請參閱下列範例。

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

在範例中，磁碟區附加到虛擬伺服器實體，因此命令輸出中也會顯示磁碟區附件和實體的名稱和 ID。 Active 屬性為 true，因為連接磁碟區的虛擬伺服器實體正在執行。 Busy 屬性的值為 false，表示此卷沒有執行必須序列化的作業。

如需可用指令選項的相關資訊，請參閱 ibmcloud is volume。

開機磁碟區的額外 CLI 屬性

當您要求檢視開機磁碟區的詳細資訊時，回應中會傳回一些額外的屬性。請參閱下列範例：

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

允許使用的屬性繼承自父開機磁碟區所建立的來源影像或快照。透過 CLI 或 API，您可以在建立實體或更新開機磁碟區時覆寫這些值。您必須擁有 is.volume.volume.manage-allowed-use IAM 角色才能進行這些更新。

這些屬性包含一個 Boolean Common Expression Language 表達式。當評估表達式為 true 時，允許使用開機磁碟區或從開機磁碟區建立的影像來配置虛擬伺服器實例或裸機伺服器。當評估表達式為 false 時，則會攔截佈建。如需詳細資訊，請參閱在自訂影像中加入允許使用的表達式。

使用 API 檢視 Block Storage for VPC 磁區

透過對 VPC REST API 進行呼叫，以程式化方式檢視 Block Storage for VPC 磁區。您可以列出所有磁區，並檢視特定磁區的詳細資料。

開始之前，請確定設定 API 環境。

使用 API 檢視所有卷冊

發出 GET /volumes 呼叫，以列出所有磁區的相關摘要資訊。請參閱下列範例。

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

成功的回應如下例所示。此範例顯示三個資料磁區。清單中的第二個附加到一個實例。

[
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "operating_system": {
      "architecture": "amd64",
      "dedicated_host_only": false,
      "display_name": "Ubuntu Linux® 20.04 LTS Focal Fossa Minimal Install (amd64)",
      "family": "Ubuntu Linux",
      "gpu_supported": [],
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
      "name": "ubuntu-20-04-amd64",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
    }
  }
]

使用 API 檢視磁區詳細資料

發出 GET /volumes/{id} 呼叫以查看磁區的詳細資料。請參閱下列範例。

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

成功回應提供磁區的詳細資料，包括容量及 IOPS、磁區狀態，以及磁區是否連接至實例。

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "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/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

開機磁碟區的額外 API 屬性

當您要求檢視開機磁碟區的詳細資訊時，GET /volumes 和 GET /volumes/{id} 要求的回應中會傳回幾個額外的屬性。

active 內容指出磁區所連接的虛擬伺服器實例是在執行中還是已停止。什麼時候 active = true，實例正在運行，並且需要正在運行的實例的操作（例如從啟動卷建立映像）也可以工作。
busy 內容指出此磁區是否正在執行必須序列化的作業。如果作業需要序列化，除非此內容是 false，否則作業會失敗。
允許使用的表達式會繼承自父開機磁碟區所建立的來源影像或快照。您只能在分離的開機磁碟區上更新允許使用表達式。使用 CLI 或 API，您可以在建立實體或更新開機磁碟區時覆寫這些值。您必須擁有 is.volume.volume.manage-allowed-use IAM 角色才能進行這些更新。這些屬性包含一個 Boolean Common Expression Language 表達式。當評估表達式為 true 時，允許使用開機磁碟區或從開機磁碟區建立的影像來配置虛擬伺服器實例或裸機伺服器。當評估表達式為 false 時，則會攔截佈建。如需詳細資訊，請參閱在自訂影像中加入允許使用的表達式。

請參閱下列範例。

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

使用 Terraform 檢視 Block Storage for VPC 磁碟區

您可以使用 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 檢視所有卷冊

將屬於帳戶的磁碟區清單匯入為唯讀資料來源。您可以依據磁碟區名稱、區域名稱、附加狀態、加密類型、作業系統系列（適用於開機磁碟區）或作業系統架構（適用於開機磁碟區）進行篩選。

data "ibm_is_volumes" "example" {
}

匯出的屬性包括磁碟區總數和磁碟區清單。巢狀屬性包括磁碟區 ID、名稱、建立日期、大小、IOPS、CRN、存取和使用者標籤、設定檔、加密類型和金鑰、生命週期狀態、健康狀態和原因、作業系統，以及其他屬性。

如需詳細資訊，請參閱 ibm _ is_volumes。

使用 Terraform 檢視卷的詳細資訊

以唯讀資料來源匯入磁碟區的詳細資料。您必須以 ID 或名稱識別卷。

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

匯出的屬性包括磁碟區總數和磁碟區清單。巢狀屬性包括磁碟區 ID、名稱、建立日期、大小、IOPS、CRN、存取和使用者標籤、設定檔、加密類型和金鑰、生命週期狀態、健康狀態和原因、作業系統，以及其他屬性。

如需詳細資訊，請參閱 ibm _ is_volume。

開機磁碟區的額外 Terraform 屬性

允許使用的表達式會繼承自父開機磁碟區所建立的來源影像或快照。您只能在分離的開機磁碟區上更新允許使用表達式。使用 Terraform，您可以在建立實體或更新開機磁碟區時覆寫這些值。您必須擁有 is.volume.volume.manage-allowed-use IAM 角色才能進行這些更新。這些屬性包含一個 Boolean Common Expression Language 表達式。當評估表達式為 true 時，允許使用開機磁碟區或從開機磁碟區建立的影像來配置虛擬伺服器實例或裸機伺服器。當評估表達式為 false 時，則會攔截佈建。如需詳細資訊，請參閱在自訂影像中加入允許使用的表達式。

檢視 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 檢視所有磁碟區

從 CLI 檢視磁碟區的詳細資訊

開機磁碟區的額外 CLI 屬性

使用 API 檢視 Block Storage for VPC 磁區

使用 API 檢視所有卷冊

使用 API 檢視磁區詳細資料

開機磁碟區的額外 API 屬性

使用 Terraform 檢視 Block Storage for VPC 磁碟區

使用 Terraform 檢視所有卷冊

使用 Terraform 檢視卷的詳細資訊

開機磁碟區的額外 Terraform 屬性

下一步