建立及管理磁碟區集區

磁碟區集區是頂層區域性資源,可為專案和虛擬私有雲 (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 狀態後,請選擇要如何從集區佈建及掛接磁碟區:

管理磁碟區集區

您可以查看現有磁碟區集區的詳細資料、列出區域內的集區、更新標籤和容量配額等設定,或刪除磁碟區集區。

Google Cloud 控制台

您可以直接在Google Cloud 控制台查看磁碟區集區,並監控集區容量:

  1. 前往 Google Cloud 控制台的 Filestore「Volume pools」(磁碟區集區) 頁面。

    前往「Volume pools」(磁碟區集區) 頁面

  2. 按一下清單中的任何磁碟區集區,開啟「Volume pool details」(磁碟區集區詳細資料) 頁面。

  3. 在「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 中繼資料作業數量。

後續步驟