本文件說明如何列出、描述、修改及刪除儲存空間集區。
事前準備
-
如果尚未設定,請先設定驗證機制。驗證是指驗證身分,以便存取 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
-
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.
- Set a default region and zone.
REST
To use the REST API samples on this page in a local development environment, you use the credentials you provide to the 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.
For more information, see Authenticate for using REST in the Google Cloud authentication documentation.
-
必要角色和權限
如要取得管理儲存空間叢集所需的權限,請要求管理員為您授予專案的下列 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。
主控台
前往 Google Cloud 控制台中的「Storage pools」(儲存空間資源池) 頁面。
前往「儲存空間集區」頁面這個頁面會顯示在所選專案中建立的儲存空間集區。
選用:使用「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。
主控台
前往 Google Cloud 控制台中的「Storage pools」(儲存空間資源池) 頁面。
前往「儲存空間集區」頁面這個頁面會顯示在所選專案中建立的儲存空間集區。
在「Name」(名稱) 欄位中,按一下要查看的儲存空間池名稱。
系統隨即會開啟「Manage storage pool」(管理儲存空間集區) 頁面。
在「儲存空間集區磁碟」部分,您可以查看儲存空間集區中建立的磁碟。
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。
主控台
- 前往 Google Cloud 控制台中的「Storage pools」(儲存空間資源池) 頁面。
前往「儲存空間集區」頁面 您可以查看頁面上列出的每個儲存空間集區的下列資訊:
- 狀態
- 名稱
- 位置
- 集區類型
- 集區容量
- 剩餘集區容量
- 集區 IOPS
- 剩餘的集區 IOPS
- 在集區中建立的磁碟數量
在「Name」欄位中,按一下要查看的儲存空間資源池名稱。
系統隨即會開啟「Manage storage pool」(管理儲存空間集區) 頁面。
您可以在頁面頂端的圖塊中查看已佈建和使用的容量,以及儲存空間集區的已佈建和使用中的總處理量和 IOPS。
在「儲存空間集區設定」部分,您可以查看儲存空間集區的其他屬性,例如建立時間、容量佈建類型、效能佈建類型、儲存空間集區中的磁碟總數,以及容量、總處理量和 IOPS 的使用率百分比。
在「Storage pool disks」(儲存空間磁碟) 專區,您可以查看儲存空間叢集中建立的磁碟相關資訊。
選用:如要進一步瞭解儲存空間集區的用量,請按一下「監控」分頁,查看各種儲存空間集區指標的圖表。詳情請參閱「監控 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 或總處理量,您必須為專案和區域提供可用的配額。
主控台
- 前往 Google Cloud 控制台中的「Storage pools」(儲存空間資源池) 頁面。
前往「儲存空間集區」頁面 在「Name」欄位中,按一下要修改的儲存空間集區名稱。
系統隨即會開啟「Manage storage pool」(管理儲存空間集區) 頁面。
按一下「Edit」(編輯)
。「Edit storage pool」頁面隨即開啟。
選用:在「儲存空間集區容量」欄位中,輸入集區的配置容量新值。新值必須比目前值多或少至少 1 TiB,最多 100 TiB。最小大小不得小於 10 TiB,最大大小不得超過 1,024 TiB。
選用:在「已配置的傳送量」欄位中,輸入已配置傳送量的新值。
選用:如果儲存空間集區類型為 Hyperdisk Balanced,請在「已佈建 IOPS」欄位中,輸入已佈建 IOPS 的新值。
按一下「儲存」,更新儲存空間資源池。
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:選用:儲存空間集區的佈建吞吐量,以 MBps 為單位。
- 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:選用:儲存空間資源池已配置的處理量,以 MB/s 為單位。
刪除儲存空間集區
如要刪除或移除儲存空間集區,您必須先刪除儲存空間集區中的所有磁碟。接著,您可以使用 Google Cloud 控制台、Google Cloud CLI 或 REST 刪除儲存空間集區。
刪除儲存空間集區後無法復原。不過,刪除儲存空間集區不會刪除儲存空間集區中建立的磁碟快照。您必須個別刪除快照。
主控台
- 前往 Google Cloud 控制台中的「Storage Pool」(儲存空間資源池) 頁面。
前往「Storage Pool」(儲存空間集區) 頁面 在「Name」欄位中,按一下要移除的儲存池名稱。
系統隨即會開啟「Manage storage pool」(管理儲存空間集區) 頁面。
在「儲存空間集區磁碟」專區中,確認儲存空間集區中沒有列出任何磁碟。
按一下
「刪除集區」。
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:不重複的儲存空間集區名稱。
後續步驟
- 進一步瞭解儲存空間集區。