管理 Hyperdisk 儲存空間集區

本文說明如何列出、描述、修改及刪除儲存空間集區。

事前準備

  • 如果尚未設定驗證，請先完成設定。 「驗證」是指驗證身分的程序，確認您有權存取 Google Cloud 服務和 API。如要從本機開發環境執行程式碼或範例，請選取下列任一選項，向 Compute Engine 進行驗證：

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. 安裝 Google Cloud CLI。 安裝完成後，執行下列指令初始化 Google Cloud CLI： 

      gcloud init

      如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

    2. Set a default region and zone.

    REST

    如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

      安裝 Google Cloud CLI。 安裝完成後，執行下列指令初始化 Google Cloud CLI： 

      gcloud init

      如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

    詳情請參閱 Google Cloud 驗證說明文件中的「Authenticate for using REST」。

必要角色和權限

如要取得管理儲存集區所需的權限，請要求管理員為您授予專案的下列 IAM 角色：

  • Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1)
  • 如要連線至可當做服務帳戶執行的 VM 執行個體： 服務帳戶使用者 (v1) (roles/iam.serviceAccountUser 角色)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這些預先定義的角色具備管理儲存集區所需的權限。如要查看確切的必要權限，請展開「必要權限」部分：

所需權限

如要管理儲存空間集區，必須具備下列權限：

  • 如要列出專案和區域的儲存空間集區，請執行下列指令： compute.storagePools.list
  • 如要列出儲存空間集區中的磁碟： compute.storagePools.get
  • 如要查看儲存空間集區的屬性，請執行下列操作： compute.storagePools.get
  • 如要更新儲存空間集區的佈建容量或效能，請按照下列步驟操作：
    • compute.storagePools.get
    • compute.storagePools.update
  • 如要刪除儲存空間集區： compute.storagePools.delete

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

限制

管理 Hyperdisk 儲存空間集區時，請注意下列限制：

  • 在 24 小時內，您最多可以變更儲存空間集區的佈建容量或效能兩次。
  • 您無法變更集區的佈建模式，也無法將標準容量儲存空間集區變更為進階容量儲存空間集區，或將進階效能儲存空間集區變更為標準效能儲存空間集區。
  • 不允許在儲存空間集區中移動磁碟。如要將磁碟移入或移出儲存集區，必須從快照重新建立磁碟。詳情請參閱「變更磁碟類型」。
  • 您無法複製、建立即時快照，或設定儲存集區中磁碟的非同步複製。
  • 每小時最多可刪除 5 個儲存空間集區。
  • 儲存集區管理指令會立即成功或失敗，但完成動作最多可能需要 5 分鐘，變更最多可能需要 30 分鐘才會顯示。

如要查看 Hyperdisk 儲存空間集區的完整限制清單，請參閱「儲存空間集區的限制」。

修改儲存空間集區時的值範圍

建立儲存空間集區時，大小、IOPS 和輸送量的新值必須在您修改的儲存空間集區類型限制內。此外，您只能使用支援的增量值指定新值。

如需詳細的效能佈建限制，請參閱「儲存集區的限制」。

列出專案的儲存空間集區

如要查看專案中建立的儲存集區，請使用Google Cloud 控制台、Google Cloud CLI 或 REST。

主控台

  1. 前往 Google Cloud 控制台的「儲存空間集區」頁面。
    前往「儲存集區」頁面

    這個頁面會顯示所選專案中建立的儲存空間集區。

  2. 選用：使用「篩選器」列，只顯示符合篩選器參數的儲存空間集區，例如位置、類型、名稱和剩餘集區容量。

gcloud

如要列出目前專案中建立的所有儲存集區，請使用 gcloud compute storage-pools list 指令。

gcloud compute storage-pools list

如要將結果限制在特定區域或地帶，可以使用 --filter 旗標，例如：

  • --filter="zone ~ us
  • --filter="zone=us-east4-c"

REST

如要顯示專案和區域中建立的儲存集區，請使用 storagePools.list 方法建構 GET 要求。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools

更改下列內容：

  • PROJECT_ID：包含儲存集區的專案 ID
  • ZONE：儲存集區所在的可用區，例如 us-central1-a。

列出儲存空間集區中的磁碟

如要取得儲存集區中建立的磁碟清單，請使用Google Cloud 控制台、Google Cloud CLI 或 REST。

主控台

  1. 前往 Google Cloud 控制台的「儲存空間集區」頁面。
    前往「儲存集區」頁面

    這個頁面會顯示所選專案中建立的儲存空間集區。

  2. 在「Name」(名稱) 欄位中，按一下要查看的儲存集區名稱。

    「管理儲存空間集區」頁面隨即開啟。

  3. 在「儲存空間集區磁碟」部分，您可以看到在儲存空間集區中建立的磁碟。

gcloud

如要列出在儲存集區中建立的磁碟，請使用 gcloud compute storage-pools list-disks 指令。

gcloud compute storage-pools list-disks STORAGE_POOL_NAME  \
    [--zone=ZONE]

更改下列內容：

  • STORAGE_POOL_NAME：儲存空間集區的名稱。
  • ZONE：選用。儲存空間集區所在的區域，例如 us-central1-a。

REST

如要列出使用儲存空間集區的磁碟，請使用 storagePools.listDisks 方法建構 GET 要求。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME/listDisks

更改下列內容：

  • PROJECT_ID：包含儲存集區的專案 ID
  • ZONE：儲存集區所在的可用區，例如 us-central1-a。
  • STORAGE_POOL_NAME：儲存空間集區的名稱。

描述儲存空間集區

如要查看儲存集區的詳細資料，可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST。

主控台

  1. 前往 Google Cloud 控制台的「儲存空間集區」頁面。
    前往「儲存集區」頁面

  2. 您可以查看頁面上列出的每個儲存空間集區的下列資訊：

    • 狀態
    • 名稱
    • 位置
    • 集區類型
    • 集區容量
    • 剩餘集區容量
    • 集區 IOPS
    • 剩餘的集區 IOPS
    • 集區中建立的磁碟數量

  3. 在「Name」(名稱) 欄位中，按一下要查看的儲存集區名稱。

    「管理儲存空間集區」頁面隨即開啟。

  4. 頁面頂端的圖塊會顯示儲存空間集區的佈建和使用容量，以及佈建和使用的處理量和 IOPS。

  5. 在「儲存空間集區設定」部分，您可以查看儲存空間集區的其他屬性，例如建立時間、容量佈建類型、效能佈建類型、儲存空間集區中的磁碟總數，以及容量、總處理量和 IOPS 的使用率百分比。

  6. 在「儲存集區磁碟」部分，您可以查看儲存集區中建立的磁碟相關資訊。

  7. 選用：如要進一步瞭解儲存空間集區用量，可以按一下「監控」分頁，查看各種儲存空間集區指標的圖表。詳情請參閱「監控 Hyperdisk 儲存空間集區」。

gcloud

使用 gcloud compute storage-pools describe 指令查看儲存集區的詳細資料。

gcloud compute storage-pools describe STORAGE_POOL_NAME  \
    [--zone=ZONE]

更改下列內容：

  • STORAGE_POOL_NAME：不重複的儲存空間集區名稱。
  • ZONE：選用。儲存空間集區所在的區域，例如 us-central1-a。

REST

如要擷取儲存集區的詳細資料，請使用 storagePools.get 方法建構 GET 要求。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

更改下列內容：

  • PROJECT_ID：包含儲存集區的專案 ID
  • ZONE：儲存集區所在的可用區，例如 us-central1-a
  • STORAGE_POOL_NAME：儲存空間集區的名稱

更新儲存空間集區的佈建容量、IOPS 或處理量

您可以增加或減少儲存空間集區的佈建容量、IOPS 或處理量。如要增加儲存集區的容量、IOPS 或總處理量，專案和區域必須有可用配額。

主控台

  1. 前往 Google Cloud 控制台的「儲存空間集區」頁面。
    前往「儲存集區」頁面

  2. 在「Name」(名稱) 欄位中，按一下要修改的儲存集區名稱。

    「管理儲存空間集區」頁面隨即開啟。

  3. 按一下「Edit」(編輯)。

    「編輯儲存空間集區」頁面隨即開啟。

  4. 選用：在「儲存空間集區容量」欄位中，輸入集區佈建容量的新值。新值必須至少為 1 TiB，且與目前值相差最多 100 TiB。最小容量不得少於 10 TiB，最大容量不得超過 1,024 TiB。

  5. 選用：在「佈建輸送量」欄位中，輸入佈建輸送量的新值。

  6. 選用：如果是 Hyperdisk Balanced 類型的儲存空間集區，請在「佈建 IOPS」欄位中輸入新的佈建 IOPS 值。

  7. 按一下「儲存」，更新儲存集區。

gcloud

使用 gcloud compute storage-pools update 指令修改儲存空間集區。

gcloud compute storage-pools update STORAGE_POOL_NAME  \
    --zone=ZONE   \
    --provisioned-capacity=POOL_SIZETiB   \
    --provisioned-iops=IOPS   \
    --provisioned-throughput=THROUGHPUT   \
    --description=DESCRIPTION

更改下列內容：

  • STORAGE_POOL_NAME：儲存空間集區的名稱。
  • ZONE：(選填) 儲存空間集區所在的可用區，例如 us-central1-a。
  • POOL_SIZE：選填：儲存空間集區的佈建容量 (以 TiB 為單位)。
  • IOPS：選用：儲存空間集區佈建 IOPS。 這個旗標只能與 Hyperdisk Balanced 儲存空間集區搭配使用。
  • THROUGHPUT：選用：佈建的儲存空間集區輸送量，單位為 MiB/秒。
  • DESCRIPTION：(選填) 儲存集區的說明字串。

REST

如要更新儲存空間集區，請使用 storagePools.update 方法建構 PATCH 要求。

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

{
    "description": "DESCRIPTION",
    "poolProvisionedCapacityGb": "SIZE",
    "poolProvisionedIops": "IOPS",
    "poolProvisionedThroughput": "THROUGHPUT"
}

更改下列內容：

  • PROJECT_ID：專案 ID
  • ZONE：儲存集區所在的可用區，例如 us-central1-a。
  • STORAGE_POOL_NAME：儲存空間集區的名稱。
  • DESCRIPTION：選填：說明儲存集區的文字欄位。
  • SIZE：(選填) 新儲存空間集區的佈建容量，以 GiB 為單位。
  • IOPS：(選填) 儲存集區已佈建 IOPS 的新值。只有在儲存空間集區包含 hyperdisk-balanced 類型的磁碟時，才能指定這項屬性。
  • THROUGHPUT：選填：儲存集區佈建輸送量的新值，以 MiB/s 為單位指定。

刪除儲存空間集區

如要刪除或移除儲存空間集區，必須先刪除儲存空間集區中的所有磁碟。接著，您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST 刪除儲存空間集區。

儲存空間集區刪除後無法復原。 不過，刪除儲存空間集區不會刪除從該集區建立的磁碟所製作的任何快照。您必須個別刪除快照。

主控台

  1. 前往 Google Cloud 控制台的「Storage Pool」(儲存集區) 頁面。
    前往「儲存集區」頁面

  2. 在「Name」(名稱) 欄位中，按一下要移除的儲存集區名稱。

    「管理儲存空間集區」頁面隨即開啟。

  3. 在「儲存空間集區磁碟」部分，確認儲存空間集區沒有列出任何磁碟。

  4. 按一下「刪除集區」。

gcloud

使用 gcloud compute storage-pools delete 指令刪除儲存集區。

gcloud compute storage-pools delete STORAGE_POOL_NAME  \
    --zone=ZONE   \

更改下列內容：

  • STORAGE_POOL_NAME：不重複的儲存空間集區名稱。
  • ZONE：(選填) 儲存集區所在的可用區，例如 us-central1-a。

REST

如要移除儲存集區，請對 storagePools.delete 方法建構 DELETE 要求。

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/storagePools/STORAGE_POOL_NAME

更改下列內容：

  • PROJECT_ID：專案 ID
  • ZONE：儲存集區所在的可用區，例如 us-central1-a。
  • STORAGE_POOL_NAME：不重複的儲存空間集區名稱。

後續步驟