管理 Hyperdisk 集區

本文說明如何列出、描述、修改及刪除 Hyperdisk 集區。

事前準備

  • 如果尚未設定驗證，請先完成設定。驗證機制會確認您的身分，以便授予 Google Cloud 服務和 API 的存取權。如要從本機開發環境執行程式碼或範例，您可以選取下列其中一個選項，向 Compute Engine 進行驗證：

    請根據您打算如何使用本頁範例，選取對應的分頁標籤：

    控制台

    使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，您不需要設定驗證機制。

    gcloud

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

      gcloud init

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

  • 設定預設區域和可用區。

    • REST

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

      安裝 Google Cloud CLI。

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

    詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」一節。

必要角色和權限

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

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

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

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

所需權限

必須具備下列權限，才能管理集區：

  • 如要列出專案和可用區的集區，請按照下列步驟操作： compute.storagePools.list
  • 如要列出集區中的磁碟，請按照下列步驟操作： compute.storagePools.get
  • 如要查看集區的屬性，請按照下列指示操作： compute.storagePools.get
  • 如要更新集區的已佈建容量或效能，請按照下列步驟操作：
    • compute.storagePools.get
    • compute.storagePools.update
  • 如要刪除集區，請按照下列步驟操作： compute.storagePools.delete

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

限制

管理集區的限制：

  • 您無法變更集區的佈建模式。舉例來說，您無法將標準容量儲存空間集區變更為進階容量儲存空間集區，也無法將進階效能儲存空間集區變更為標準效能儲存空間集區。
  • 您無法將磁碟移入或移出集區，必須從標準快照重新建立磁碟。詳情請參閱「變更磁碟類型」。
  • 您無法複製集區中的磁碟、建立即時快照，或設定非同步複製。

儲存空間集區的特定限制：

  • 24 小時內，您最多可以變更儲存空間集區的佈建容量或效能兩次。
  • 每小時最多可刪除 5 個儲存空間集區。
  • 儲存空間集區管理指令會立即成功或失敗，但最多可能需要 5 分鐘才能完成動作，且最多需要 30 分鐘才會顯示變更。

Exapool 專屬限制：

  • 如要變更 Exapool 的佈建容量、IOPS 或處理量，請務必聯絡帳戶團隊。
  • 如要刪除 Exapool，請與帳戶團隊聯絡。

如需完整限制清單，請參閱「儲存空間集區限制」和「Exapool 限制」。

修改集區時的值範圍

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

如要瞭解詳細的效能佈建限制，請參閱「儲存空間集區限制」和「Exapool 的大小和效能限制」。

列出專案的集區

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

控制台

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

  2. 選取「Exapools」或「儲存空間集區」分頁標籤。

    這個頁面會顯示在所選專案中建立的集區。

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

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 控制台的「Storage pools」(儲存空間集區) 頁面。
    前往「Storage pools」(儲存空間集區) 頁面

  2. 選取「Exapools」或「儲存空間集區」分頁標籤。

    這個頁面會顯示在所選專案中建立的集區。

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

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

  4. 在「Storage pool disks」(儲存空間集區磁碟) 區段中，您可以看到在集區中建立的磁碟。

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 控制台的「Storage pools」(儲存空間集區) 頁面。
    前往「Storage pools」(儲存空間集區) 頁面

  2. 選取「Exapools」或「儲存空間集區」分頁標籤。

  3. 頁面列出的每個集區都會顯示下列資訊：

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

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

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

  5. 在頁面頂端的圖塊中，您可以查看集區的已佈建和已使用容量，以及已佈建和已使用的處理量和 IOPS。

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

  7. 在「Storage pool disks」(儲存空間集區磁碟) 區段中，您可以查看集區中建立的磁碟相關資訊。

  8. 選用：如要進一步瞭解集區用量，可以點選「Monitoring」(監控) 分頁標籤，查看各種集區指標的圖表。詳情請參閱「監控集區」。

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 或處理量，專案和區域必須有可用配額。儲存空間集區最多可能需要 30 分鐘，才會顯示新的佈建值。

控制台

  1. 前往 Google Cloud 控制台的「Storage pools」(儲存空間集區) 頁面。
    前往「Storage pools」(儲存空間集區) 頁面
  2. 選取「儲存空間集區」分頁標籤。

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

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

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

    「Edit storage pool」(編輯儲存空間集區) 頁面隨即開啟。

  5. 選用：在「Storage pool capacity」(儲存空間集區容量) 欄位中，輸入集區佈建容量的新值。新值與目前值的差距必須至少為 1 TiB，且不超過 100 TiB。新值可以大於或小於目前的值。大小下限不得低於 10 TiB，上限不得超過 5 PiB。

  6. 選用：在「Provisioned throughput」(佈建輸送量) 欄位中，輸入新的佈建輸送量值。

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

  8. 按一下「儲存」，更新儲存空間集區。

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/s。
  • 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 為單位。

修改 Exapool

如要變更 Exapool 的佈建容量、IOPS 或處理量，請聯絡帳戶團隊。

刪除集區

集區刪除後即無法復原。不過，刪除集區並不會刪除從集區中建立的磁碟所建立的任何快照。必須分別刪除。

刪除儲存空間集區

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

控制台

  1. 前往 Google Cloud 控制台的「Storage pools」(儲存空間集區) 頁面。
    前往「Storage pools」(儲存空間集區) 頁面
  2. 選取「儲存空間集區」分頁標籤。

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

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

  4. 在「Storage pool disks」(儲存空間集區磁碟) 區段中，確認儲存空間集區未列出任何磁碟。

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

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：不重複的集區名稱。

刪除 Exapool

如要刪除 Exapool，請與帳戶團隊聯絡。

後續步驟