Crea y administra grupos de volúmenes

Un grupo de volúmenes es el recurso regional de nivel superior que administra un grupo compartido de capacidad de almacenamiento y de IOPS para tu proyecto y tu red de nube privada virtual (VPC). Dentro de un grupo de volúmenes, puedes aprovisionar hasta 20 millones de volúmenes independientes y livianos (con hasta 50,000 volúmenes activos de forma simultánea y hasta 5 PB de capacidad usada) para entornos de pruebas de agentes de IA, espacios de trabajo de desarrolladores o cargas de trabajo generales de múltiples usuarios.

Antes de comenzar

Completa los requisitos previos que se describen en Configura volúmenes de agentes de Filestore.

Crea un grupo de volúmenes

API de REST

Para crear un grupo de volúmenes, envía una solicitud HTTP POST al extremo 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"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la región en la que se implementa el grupo, como us-central1.
  • VOLUME_POOL_ID: Es el identificador del grupo de volúmenes, que coincide con ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$.
  • VPC_NETWORK: Es el nombre de una red de VPC existente.

Campos de solicitud

El cuerpo de la solicitud contiene los siguientes campos:

Campo Tipo Obligatorio Descripción
network string Obligatorio La ruta de acceso del recurso de tu red de VPC, con el siguiente formato: projects/{project}/global/networks/{network}. La red debe tener una política de conexión de servicio de PSC válida.
defaultVolumeQuotaMib int32 Opcional Es la cuota predeterminada por volumen en MiB. El valor debe estar entre 100 MiB y 102,400 MiB (100 GiB). El valor predeterminado es 1,024 MiB.
activeVolumeIops int32 Opcional Especifica la cantidad de IOPS aprovisionadas por volumen activo dentro del grupo de volúmenes. El valor predeterminado es 3,000 IOPS; el máximo es 10,000 IOPS. Las IOPS se aprovisionan y facturan a nivel del grupo de volúmenes. Para obtener más información sobre los precios, consulta la página de precios de Filestore.
description string Opcional Es una descripción fácil de usar del grupo de volúmenes.
labels map[string, string] Opcional Son pares clave-valor que te permiten organizar y filtrar recursos en Google Cloud.
autoFreezeDelay string Opcional Es la duración que un volumen debe permanecer desconectado (con ACL de IP vacías) antes de que se asigne automáticamente al almacenamiento de COLD. El formato es una cadena de duración que termina con s (por ejemplo, 604800s para 7 días). El valor predeterminado es de 7 días.

Respuesta

El método devuelve un objeto de operación de larga duración (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
}

Sondea la operación hasta que done sea 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"

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la región en la que se implementa el grupo de volúmenes, como us-central1.
  • OPERATION_ID: Es el ID de la operación que se muestra en la respuesta de creación.

Cuando se completa, la operación devuelve el objeto VolumePool con el estado READY.

Después de que tu grupo de volúmenes alcance el estado READY, elige cómo deseas aprovisionar y activar los volúmenes del grupo:

Administra grupos de volúmenes

Puedes ver detalles sobre los grupos de volúmenes existentes, enumerar los grupos dentro de una región, actualizar parámetros de configuración, como etiquetas y cuotas de capacidad, o borrar grupos de volúmenes.

Consola de Google Cloud

Puedes ver los grupos de volúmenes y supervisar la capacidad de los grupos directamente en la consola deGoogle Cloud :

  1. En la consola de Google Cloud , ve a la página Grupos de volúmenes de Filestore.

    Ir a Grupos de volúmenes

  2. Haz clic en cualquier grupo de volúmenes de la lista para abrir la página Detalles del grupo de volúmenes.

  3. En la pestaña Supervisión, consulta los gráficos en tiempo real del recuento de volúmenes activos, la capacidad de almacenamiento, las IOPS y la latencia de E/S.

API de REST

En cada una de las siguientes solicitudes, reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de Google Cloud .
  • LOCATION: Es la región en la que se implementa el grupo de volúmenes, como us-central1.
  • VOLUME_POOL_ID: Es el identificador del grupo de volúmenes.

Obtén información sobre un grupo de volúmenes

Para recuperar detalles sobre un grupo de volúmenes específico, haz lo siguiente:

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"

Enumera grupos de volúmenes

Para enumerar todos los grupos de volúmenes en una región determinada, haz lo siguiente:

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

Actualiza un grupo de volúmenes

Para actualizar la descripción o las etiquetas de un grupo de volúmenes existente, envía una solicitud PATCH con un parámetro de consulta 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"
    }
  }'

El método PATCH devuelve una operación de larga duración. Puedes sondear la operación hasta que se complete.

Borra un grupo de volúmenes

Antes de borrar un grupo de volúmenes, debes borrar todos los volúmenes secundarios aprovisionados dentro del grupo. Para borrar un grupo de volúmenes, haz lo siguiente:

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"

Supervisa los grupos de volúmenes

Puedes supervisar el rendimiento, la capacidad y los recuentos de volúmenes de tus grupos de volúmenes con Cloud Monitoring y la consola de Google Cloud .

Métricas de supervisión

Filestore exporta 12 métricas dedicadas en el espacio de nombres file.googleapis.com/volume_pool/:

Tipo de métrica Nombre visible Tipo Unidad Descripción
volume_pool/volumes Volúmenes GAUGE {volume} Es la cantidad de volúmenes en el grupo de volúmenes, desglosada por estado del ciclo de vida.
volume_pool/used_bytes Bytes usados GAUGE By Es la capacidad total usada en el grupo de volúmenes.
volume_pool/cold_used_bytes Bytes usados en frío GAUGE By Es el almacenamiento total que consumen los volúmenes en el nivel COLD dentro del grupo de volúmenes.
volume_pool/provisioned_iops IOPS aprovisionadas GAUGE {operation}/s Es el límite de IOPS aprovisionadas para el grupo de volúmenes.
volume_pool/read_ops_count Recuento de operaciones de lectura DELTA {operation} Es el recuento de operaciones de lectura en todos los volúmenes del grupo de volúmenes.
volume_pool/write_ops_count Recuento de operaciones de escritura DELTA {operation} Es el recuento de operaciones de escritura en todos los volúmenes del grupo de volúmenes.
volume_pool/total_ops_count Recuento total de operaciones DELTA {operation} Es el recuento de operaciones de lectura y escritura en todos los volúmenes del grupo de volúmenes.
volume_pool/read_bytes_count Bytes leídos DELTA By Son los bytes leídos en todos los volúmenes del grupo de volúmenes.
volume_pool/write_bytes_count Bytes escritos DELTA By Bytes escritos en todos los volúmenes del grupo de volúmenes.
volume_pool/average_read_latency Latencia de lectura promedio GAUGE ms Es la latencia promedio de las operaciones de lectura en todos los volúmenes del grupo de volúmenes.
volume_pool/average_write_latency Latencia de escritura promedio GAUGE ms Es la latencia promedio de las operaciones de escritura en todos los volúmenes del grupo de volúmenes.
volume_pool/metadata_ops_count Recuento de operaciones de metadatos DELTA {operation} Es el recuento de operaciones de metadatos de NFS en todos los volúmenes del grupo de volúmenes.

¿Qué sigue?