ボリューム プールを作成して管理する

ボリューム プールは、プロジェクトと Virtual Private Cloud（VPC）ネットワークのストレージ容量と IOPS の共有プールを管理する最上位のリージョン リソースです。ボリューム プール内では、AI エージェント サンドボックス、デベロッパー ワークスペース、一般的なマルチテナント ワークロード用に、最大 2,000 万個の独立した軽量ボリューム（最大 50,000 個の同時アクティブ ボリューム、最大 5 PB の使用容量）をプロビジョニングできます。

始める前に

Filestore エージェント ボリュームを設定するに記載されている前提条件を完了します。

ボリューム プールを作成する

REST API

ボリューム プールを作成するには、volumePools.create エンドポイントに HTTP POST リクエストを送信します。

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: ボリューム プールの識別子。^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$ と一致します。
  • VPC_NETWORK: 既存の VPC ネットワークの名前。

リクエスト フィールド

リクエスト本文には次のフィールドが含まれます。

フィールド 種類 必須 説明
network string 必須 VPC ネットワークのリソースパス。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でリソースを整理してフィルタできる Key-Value ペア。
autoFreezeDelay string 省略可 ボリュームが自動的に COLD ストレージに階層化されるまでに、ボリュームが切断された状態（IP ACL が空の状態）を維持する必要がある期間。形式は、s で終わる期間文字列です（例: 7 日間の場合は 604800s）。デフォルトは 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 の [ボリューム プール] ページに移動します。

    [ボリューム プール] に移動

  2. リスト内のボリューム プールをクリックして、[ボリューム プールの詳細] ページを開きます。

  3. [モニタリング] タブで、アクティブなボリューム数、ストレージ容量、IOPS、I/O レイテンシのリアルタイム グラフを表示します。

REST API

次の各リクエストで、次のように置き換えます。

  • PROJECT_ID: Google Cloud プロジェクト ID。
  • LOCATION: ボリューム プールがデプロイされているリージョン（us-central1 など）。
  • 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/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"

ボリューム プールを更新する

既存のボリューム プールの説明またはラベルを更新するには、updateMask クエリ パラメータを指定して PATCH リクエストを送信します。

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/ Namespace に 12 個の専用指標をエクスポートします。

指標タイプ 表示名 種類 単位 説明
volume_pool/volumes ボリューム GAUGE {volume} ボリューム プール内のボリューム数（ライフサイクル状態別）。
volume_pool/used_bytes 使用済みバイト数 GAUGE By ボリューム プールの合計使用容量。
volume_pool/cold_used_bytes コールド使用バイト数 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 メタデータ オペレーションの数。

次のステップ