管理 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」(必要權限) 部分：

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

限制

管理集區的限制：

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

儲存空間集區的限制：

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

Exapools 特有的限制：

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

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

修改集區時的值範圍

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

如需詳細的效能資源調度限制，請參閱「儲存集區的限制」和「Exapool 的大小和效能限制」。

列出專案的集區

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

gcloud compute storage-pools list

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

列出集區中的磁碟

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

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

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

描述集區

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

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

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

修改集區

您可以增加或減少集區的佈建容量、IOPS 或處理量。

修改儲存空間集區

如要增加儲存空間集區的容量、IOPS 或處理量，專案和區域必須有可用配額。儲存集區最多可能需要 30 分鐘，才會顯示新的佈建值。

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

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

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

修改 Exapool

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

刪除集區

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

刪除儲存空間集區

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

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

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

刪除 Exapool

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

後續步驟

• 進一步瞭解 Hyperdisk 集區。