管理 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 分鐘才會顯示。

Exapools 的專屬限制：

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

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

修改集區時的值範圍

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

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

列出專案的集區

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

控制台

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

  2. 選取「Exapools」或「Storage Pools」分頁標籤。

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

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

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」(儲存空間集區) 頁面。
    前往「儲存集區」頁面

  2. 選取「Exapools」或「Storage Pools」分頁標籤。

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

  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」(儲存空間集區) 頁面。
    前往「儲存集區」頁面

  2. 選取「Exapools」或「Storage Pools」分頁標籤。

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

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

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

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

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

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

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

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

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」(儲存空間集區) 頁面
  2. 選取「Storage Pools」(儲存空間集區) 分頁標籤。

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

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

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

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

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

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

  7. 選用：如果是 Hyperdisk Balanced 儲存空間集區，請在「佈建 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 控制台的「儲存集區」頁面。
    前往「儲存集區」頁面
  2. 1. 選取「儲存空間集區」分頁標籤。

  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，請與帳戶團隊聯絡。

後續步驟