管理 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. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

必要角色和權限

如要取得管理儲存空間叢集所需的權限，請要求管理員為您授予專案的下列身分與存取權管理角色：

• Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1)
• 如要連線至可當做服務帳戶執行的 VM 執行個體，請按照下列步驟操作： 服務帳戶使用者 (v1) (roles/iam.serviceAccountUser 角色)

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

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

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

限制

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

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

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

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

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

如需詳細的效能配置限制，請參閱「儲存空間資源池的限制」。

列出專案的儲存空間集區

如要查看在專案中建立的儲存空間集區，請使用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 或處理量。如要提高儲存空間資源池的容量、IOPS 或總處理量，您必須為專案和區域提供可用的配額。

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"
}

刪除儲存空間集區

如要刪除或移除儲存空間集區，您必須先刪除儲存空間集區中的所有磁碟。接著，您可以使用 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

後續步驟

• 進一步瞭解儲存空間集區。