Créer et gérer des pools de volumes

API REST

Pour créer un pool de volumes, envoyez une requête HTTP POST au point de terminaison 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"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION : région où le pool est déployé, par exemple us-central1.
• VOLUME_POOL_ID : identifiant du pool de volumes, correspondant à ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$.
• VPC_NETWORK : nom d'un réseau VPC existant.

Champs des demandes

Le corps de la requête contient les champs suivants :

Réponse

La méthode renvoie un objet d'opération de longue durée (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
}

Interrogez l'opération jusqu'à ce que done soit défini sur 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"

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION : région où le pool de volumes est déployé, par exemple us-central1.
• OPERATION_ID : ID d'opération renvoyé dans la réponse de création.

Une fois l'opération terminée, elle renvoie l'objet VolumePool avec l'état READY.

Une fois que votre pool de volumes est à l'état READY, choisissez comment vous souhaitez provisionner et installer des volumes à partir du pool :

• Déployer avec GKE : passez à Configurer l'environnement GKE pour les volumes d'agent Filestore. Le pilote CSI Filestore provisionne et gère automatiquement les volumes de votre pool.
• Déployer avec votre propre framework d'orchestration : passez à la section Créer et gérer des volumes à l'aide de l'API REST pour provisionner, installer, cloner et hiérarchiser directement des volumes individuels.

Console Google Cloud

Vous pouvez afficher les pools de volumes et surveiller la capacité des pools directement dans la consoleGoogle Cloud  :

1. Dans la console Google Cloud , accédez à la page Pools de volumes de Filestore.

   Accéder à la page Pools de volumes

2. Cliquez sur un pool de volumes dans la liste pour ouvrir la page Détails du pool de volumes.

3. Dans l'onglet Surveillance, affichez des graphiques en temps réel pour le nombre de volumes actifs, la capacité de stockage, les IOPS et la latence d'E/S.

API REST

Dans chacune des requêtes suivantes, remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• LOCATION : région où le pool de volumes est déployé, par exemple us-central1.
• VOLUME_POOL_ID : identifiant du pool de volumes.

Obtenir des informations sur un pool de volumes

Pour récupérer des informations sur un pool de volumes spécifique :

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"

Répertorier les pools de volumes

Pour lister tous les pools de volumes d'une région donnée :

curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://file.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION/volumePools"

Mettre à jour un pool de volumes

Pour mettre à jour la description ou les étiquettes d'un pool de volumes existant, envoyez une requête PATCH avec un paramètre de requête 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"
    }
  }'

La méthode PATCH renvoie une opération de longue durée. Vous pouvez interroger l'opération jusqu'à ce qu'elle soit terminée.

Supprimer un pool de volumes

Avant de supprimer un pool de volumes, vous devez supprimer tous les volumes enfants provisionnés dans le pool. Pour supprimer un pool de volumes :

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"