磁碟區集區是頂層區域性資源,可為專案和虛擬私有雲 (VPC) 網路管理共用的儲存空間容量和 IOPS 集區。在磁碟區集區中,您最多可以佈建 2,000 萬個獨立輕量磁碟區 (最多可同時啟用 50,000 個磁碟區,且已用容量最多可達 5 PB),用於 AI 代理 Agent Sandbox、開發人員工作區或一般多租戶工作負載。
事前準備
完成「設定 Filestore 代理磁碟區」一文所述的前置作業。
建立磁碟區集區
REST API
如要建立磁碟區集區,請將 POST 要求傳送至 volumePools.create 端點:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
"description": "Production volume pool for AI agent sandboxes",
"network": "projects/PROJECT_ID/global/networks/VPC_NETWORK",
"defaultVolumeQuotaMib": 2048,
"activeVolumeIops": 1000,
"labels": {
"env": "production",
"workload": "ai-sandboxes"
}
}' \
"https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/volumePools?volumePoolId=VOLUME_POOL_ID"
更改下列內容:
PROJECT_ID: Google Cloud 專案 ID。LOCATION:部署集區的區域,例如us-central1。VOLUME_POOL_ID:磁碟區集區的 ID,與^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$相符。VPC_NETWORK:現有虛擬私有雲網路的名稱。
要求欄位
要求主體包含下列欄位:
| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
network |
string |
必填 | 虛擬私有雲網路的資源路徑,格式為:projects/{project}/global/networks/{network}。網路必須具備有效的 PSC 服務連線政策。 |
defaultVolumeQuotaMib |
int32 |
選用 | 每個磁碟區的預設配額 (以 MiB 為單位)。值必須介於 100 MiB 至 102,400 MiB (100 GiB) 之間。預設值為 1,024 MiB。 |
activeVolumeIops |
int32 |
選用 | 指定磁碟區集區中,每個運作中磁碟區佈建的 IOPS。預設值為 3,000 IOPS,上限為 10,000 IOPS。IOPS 是在磁碟區集區層級佈建和計費。如要進一步瞭解定價,請參閱 Filestore 定價頁面。 |
description |
string |
選用 | 磁碟區集區的容易使用說明。 |
labels |
map[string, string] |
選用 | 鍵/值組合,可讓您在 Google Cloud中整理及篩選資源。 |
autoFreezeDelay |
string |
選用 | 磁碟區必須保持中斷連結狀態 (IP ACL 為空白) 多久,才會自動分級至 COLD 儲存空間。格式為以 s 結尾的時間長度字串 (例如 604800s 代表 7 天)。預設值為 7 天。 |
回應
這個方法會傳回長時間執行的作業 (LRO) 物件:
{
"name": "projects/my-project/locations/us-central1/operations/operation-1694000000000-abcde",
"metadata": {
"@type": "type.googleapis.com/google.cloud.filestore.v1beta1.OperationMetadata",
"createTime": "2026-09-08T10:00:00.000Z",
"target": "projects/my-project/locations/us-central1/volumePools/my-volume-pool",
"verb": "create"
},
"done": false
}
輪詢作業,直到 done 為 true:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID"
更改下列內容:
PROJECT_ID: Google Cloud 專案 ID。LOCATION:部署磁碟區集區的區域,例如us-central1。OPERATION_ID:建立回應中傳回的作業 ID。
作業完成後,會傳回狀態為 READY 的 VolumePool 物件。
磁碟區集區達到 READY 狀態後,請選擇要如何從集區佈建及掛接磁碟區:
- 使用 GKE 部署:請前往「為 Filestore 代理磁碟區設定 GKE 環境」。Filestore CSI 驅動程式會自動佈建及管理集區中的磁碟區。
- 使用自己的自動化調度管理架構部署:請參閱「使用 REST API 建立及管理磁碟區」,直接佈建、掛接、複製及分級個別磁碟區。
管理磁碟區集區
您可以查看現有磁碟區集區的詳細資料、列出區域內的集區、更新標籤和容量配額等設定,或刪除磁碟區集區。
Google Cloud 控制台
您可以直接在Google Cloud 控制台查看磁碟區集區,並監控集區容量:
前往 Google Cloud 控制台的 Filestore「Volume pools」(磁碟區集區) 頁面。
按一下清單中的任何磁碟區集區,開啟「Volume pool details」(磁碟區集區詳細資料) 頁面。
在「Monitoring」(監控) 分頁中,查看運作中磁碟區數量、儲存空間容量、IOPS 和 I/O 延遲時間的即時圖表。
REST API
在下列各項要求中,請替換:
PROJECT_ID: Google Cloud 專案 ID。LOCATION:部署磁碟區集區的區域,例如us-central1。VOLUME_POOL_ID:磁碟區集區的 ID。
取得磁碟區集區的相關資訊
如要擷取特定磁碟區集區的詳細資料,請按照下列步驟操作:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/volumePools/VOLUME_POOL_ID"
列出磁碟區集區
如要列出指定區域中的所有磁碟區集區,請執行下列指令:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/volumePools"
更新磁碟區集區
如要更新現有磁碟區集區的說明或標籤,請傳送 PATCH 要求,並附上 updateMask 查詢參數:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/volumePools/VOLUME_POOL_ID?updateMask=description,labels" \
-d '{
"description": "Updated pool description",
"labels": {
"env": "production",
"owner": "platform-team"
}
}'
PATCH 方法會傳回長時間執行的作業。您可以輪詢作業,直到作業完成為止。
刪除磁碟區集區
刪除磁碟區集區前,必須先刪除集區內佈建的所有子磁碟區。如何刪除磁碟區集區:
curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/volumePools/VOLUME_POOL_ID"
監控磁碟區集區
您可以使用 Cloud Monitoring 和 Google Cloud 控制台,監控磁碟區集區的效能、容量和磁碟區數量。
監控指標
Filestore 會在 file.googleapis.com/volume_pool/ 命名空間下匯出 12 項專屬指標:
| 指標類型 | 顯示名稱 | 種類 | 單位 | 說明 |
|---|---|---|---|---|
volume_pool/volumes |
磁碟區 | GAUGE |
{volume} |
磁碟區集區中的磁碟區數量,依生命週期狀態細分。 |
volume_pool/used_bytes |
已使用的位元組數 | GAUGE |
By |
磁碟區集區中已使用的總容量。 |
volume_pool/cold_used_bytes |
Cold 已使用位元組 | GAUGE |
By |
磁碟區集區中「COLD」級別磁碟區使用的儲存空間總量。 |
volume_pool/provisioned_iops |
已佈建的 IOPS | GAUGE |
{operation}/s |
磁碟區集區的佈建 IOPS 限制。 |
volume_pool/read_ops_count |
讀取作業數 | DELTA |
{operation} |
磁碟區集區中所有磁碟區的讀取作業數量。 |
volume_pool/write_ops_count |
寫入作業數 | DELTA |
{operation} |
磁碟區集區中所有磁碟區的寫入作業數量。 |
volume_pool/total_ops_count |
作業總數 | DELTA |
{operation} |
磁碟區集區中所有磁碟區的讀取和寫入作業數量。 |
volume_pool/read_bytes_count |
讀取的位元組 | DELTA |
By |
磁碟區集區中所有磁碟區讀取的位元組數。 |
volume_pool/write_bytes_count |
寫入的位元組 | DELTA |
By |
磁碟區集區中所有磁碟區寫入的位元組數。 |
volume_pool/average_read_latency |
讀取作業的平均延遲時間 | GAUGE |
ms |
磁碟區集區中所有磁碟區的讀取作業平均延遲時間。 |
volume_pool/average_write_latency |
寫入作業的平均延遲時間 | GAUGE |
ms |
磁碟區集區中所有磁碟區的寫入作業平均延遲時間。 |
volume_pool/metadata_ops_count |
中繼資料作業數量 | DELTA |
{operation} |
磁碟區集區中所有磁碟區的 NFS 中繼資料作業數量。 |
後續步驟
- 設定 Filestore 代理磁碟區的 GKE 環境。
- 使用 REST API 建立及管理磁碟區,適用於自訂自動化調度管理架構。