Google Cloud NetApp Volumes te permite administrar recursos de ONTAP en un grupo de almacenamiento en modo ONTAP enviando operaciones a través de proxies de Google Cloud .
Por motivos de seguridad y registro, NetApp Volumes no permite conexiones directas a la LIF de administración de ONTAP, por lo que no puedes usar herramientas como SystemManager o SSH directamente. En su lugar, puedes enviar operaciones de ONTAP a tu grupo de almacenamiento en modo ONTAP con los siguientes métodos:
Las herramientas de administración, como Terraform, usan el proxy de la API de Google para administrar los recursos de ONTAP.
Antes de comenzar
La versión de Google Cloud CLI debe ser, al menos, 559.0.0 para administrar las operaciones de ONTAP en tu grupo de almacenamiento en modo ONTAP. Si tu versión es anterior, Google Cloud CLI devuelve un error que indica que el comando o la marca no están definidos.
Usa el proxy de la CLI de ONTAP de Google Cloud CLI
Si bien el acceso directo por SSH a la CLI de ONTAP no está disponible, puedes enviar comandos de la CLI de ONTAP a tu grupo de almacenamiento con Google Cloud CLI.
gcloud
Ejecuta un comando de ONTAP:
gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \ --location=LOCATION
Reemplaza la siguiente información:
POOL-NAME: Es el nombre del grupo de almacenamiento de ONTAP-mode de Flex Unified.ONTAP-COMMAND: Es el comando de ONTAP que deseas ejecutar en el clúster o el grupo de almacenamiento.PROJECT: Es el ID del proyecto.LOCATION: Es la ubicación de tu grupo de almacenamiento.
Usa una API de proxy de Google para las llamadas a la API de REST de ONTAP
NetApp Volumes proporciona un extremo de API de Google para cada grupo de almacenamiento en modo ONTAP unificado de Flex, lo que te permite enviar llamadas a la API de REST de ONTAP al clúster de ONTAP subyacente. Esto te permite controlar las funciones de ONTAP con APIs.
Las llamadas al proxy de ONTAP deben usar el siguiente formato de URL:
https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
Esta URL consta de los siguientes elementos:
URL de referencia:
https://netapp.googleapis.com/v1URN de Google para el grupo de almacenamiento: /projects/
PROJECT/locations/LOCATION/storagePools/POOL_NAMEReemplaza la siguiente información:
PROJECT: Es el ID del proyecto o el número.LOCATION: el nombre de la zona para los grupos zonales o la región para los grupos regionales.POOL_NAME: Es el nombre de tu grupo.
Ruta de la API de REST de ONTAP: /ontap/
ONTAP_REST_URL. Para obtener más información, consulta la referencia de la API de REST de ONTAP.
Enumera todos los volúmenes de un grupo de almacenamiento
En el siguiente ejemplo, se muestra la URL completa para enumerar todos los volúmenes del grupo de almacenamiento
mypool en us-central1-a en el proyecto myproject.
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes
Como todas las llamadas a la API de Google, esta llamada debe autenticarse. En el siguiente ejemplo de la CLI,
se recupera un token de API y, luego, se llama a la URL con curl para enumerar todos
los volúmenes del grupo:
TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
Enumera todas las instantáneas de un volumen
En el siguiente ejemplo, se muestra la URL completa para enumerar todas las instantáneas del grupo de almacenamiento
mypool y el volumen volume-uuid en us-central1-a en el proyecto
myproject.
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots
Como todas las llamadas a la API de Google, esta llamada debe autenticarse. En el siguiente ejemplo de la CLI,
se recupera un token de API y, luego, se llama a la URL con curl para enumerar todas
las instantáneas del volumen:
TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
Crear un volumen
En esta sección, se muestra cómo crear un volumen llamado myvolume en un grupo de almacenamiento
existente en modo ONTAP unificado de Flex, identificado por el URN: /projects/myproject/locations/us-central1-a/storagePools/mypool,
con la API de REST de ONTAP.
Para crear un volumen, consulta la documentación en línea de la API de REST de ONTAP. En la documentación, navega a la sección Almacenamiento y, luego, expande Administra volúmenes de almacenamiento. En esta sección, se proporcionan varios ejemplos.
Usa las siguientes instrucciones para crear un volumen.
Determina el extremo de API de REST de ONTAP.
Con el ejemplo básico en NetApp Volumes, el extremo de API de ONTAP requerido es
/api/storage/volumes. Este extremo crea la URL:https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.Crea la carga útil de la solicitud.
Usa la carga útil de ejemplo de la documentación de ONTAP para que coincida con tu entorno específico. Por ejemplo:
{ "name": "vol1", "aggregates": [ { "name": "aggr1" } ], "svm": { "name": "vs1" } }Cuando crees un volumen, usa el campo
namepara asignar el nombre del volumen. La carga útil de creación del volumen requiere los nombres del agregado y de la máquina virtual de almacenamiento (SVM) asignados por NetApp Volumes durante la creación del grupo en modo ONTAP. En el modo ONTAP, cada grupo de almacenamiento tiene una SVM y un agregado de almacenamiento. Esta información se puede recuperar consultando ONTAP para todas las SVM.Para recuperar la SVM y los nombres de los agregados, haz lo siguiente:
Usa
ontap_fieldspara la selección de campos: en los grupos de modo ONTAP de NetApp Volumes, usa el parámetro de consultaontap_fields=en lugar del parámetro estándar de ONTAPfields=para especificar los campos solicitados.Opcional: Usa
jqpara extraer campos: En el siguiente ejemplo, se usa la herramienta de código abierto jq para extraer elname(nombre de SVM) yaggregatesde la respuesta JSON, lo que es útil para el procesamiento en secuencias de comandos de shell.TOKEN=$(gcloud auth print-access-token) curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/svm/svms?ontap_fields=name,aggregates' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json" | jq '.rawResponse.records[] | {name: .name, aggregates: .aggregates[].name}'Respuesta de ejemplo:
{ "name": "gcnv-7cf6ee41c1a94f0-svm-01", "aggregates": "aggr1" }
Ejecuta la llamada a la API de creación de volúmenes.
Con el nombre del agregado (
aggr1) y el nombre de la SVM (gcnv-7cf6ee41c1a94f0-svm-01), crea la carga útil final de creación del volumen y envía la llamada a la API. Ten en cuenta que la carga útil de la API de ONTAP debe estar encerrada en un sobrebody: {}para NetApp Volumes.En el siguiente ejemplo, se crea un volumen llamado
myvolumecon un tamaño de 2 GB:curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json" \ --data '{ "body": { "name": "myvolume", "aggregates": [ { "name": "aggr1" } ], "svm": { "name": "gcnv-7cf6ee41c1a94f0-svm-01" }, "size": "2GB" } }'La creación de volúmenes admite muchos parámetros opcionales, como
size. Por ejemplo, la carga útil especifica un tamaño de 2 GB. En la página de documentación del recurso, se enumeran todos los parámetros disponibles, incluidos los obligatorios y los opcionales. También proporciona ejemplos detallados de cargas útiles y cuerpos de respuesta.Para configurar la nivelación automática en la API de REST de ONTAP, incluye el objeto JSON
tieringen el cuerpo de la solicitud:Para establecer la política de organización en niveles del volumen en
all, usa"tiering": {"policy": "all"}.Opcional: Para configurar los días de enfriamiento, usa
"tiering": {"policy": "auto", "min_cooling_days": 31}.Puedes especificar un umbral de enfriamiento de entre 2 y 183 días en el campo
min_cooling_days. El valor predeterminado del umbral de enfriamiento es de 31 días.
Para omitir el nivel de acceso frecuente y escribir datos directamente en el nivel de acceso de la nube en volúmenes de lectura y escritura (RW), usa el proxy de la CLI de ONTAP de Google Cloud CLI con privilegios avanzados:
set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
Supervisa el trabajo de ONTAP.
La mayoría de las llamadas a la API de ONTAP, como las operaciones
POSToPATCHque crean o actualizan recursos, no se ejecutan de forma síncrona. En su lugar, estas llamadas devuelven un recurso de trabajo de ONTAP, como se muestra en el ejemplo de creación de volúmenes.Ejemplo de respuesta de trabajo:
{ "body": { "job": { "_links": { "self": { "href": "curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"" } }, "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c" } } }Para verificar el estado del trabajo, consulta el recurso del trabajo con el
uuidque se muestra:curl --location 'https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/cluster/jobs/15be1c46-fd2c-11f0-b3c2-7f15697be61c' \ --header "Authorization: Bearer $TOKEN" \ --header "Content-Type: application/json"
Respuesta de ejemplo:
{ "rawResponse": { "uuid": "15be1c46-fd2c-11f0-b3c2-7f15697be61c", "description": "POST /api/storage/volumes/15be0ad9-fd2c-11f0-b3c2-7f15697be61c", "state": "success", "message": "success", "code": 0, "start_time": "2026-01-29T16:03:43+00:00", "end_time": "2026-01-29T16:03:44+00:00", "svm": { "name": "gcnv-7cf6ee41c1a94f0-svm-01", "uuid": "8a29c15d-fb31-11f0-ab03-03e1bb49206d" } } }Si el
stateessuccess, se crea el volumen.Este flujo de trabajo de ejemplo te guía para buscar acciones de ONTAP en la documentación de la API de REST de ONTAP. También se muestra cómo crear el formato de carga útil obligatorio y enviarlo al grupo de almacenamiento con una API de Google. Por último, se muestra cómo supervisar un trabajo de ONTAP hasta que se cree el recurso. Con este enfoque, puedes controlar la mayoría de los parámetros de configuración de ONTAP para tu grupo de almacenamiento.
Usa Terraform para administrar el modo ONTAP
Puedes administrar los recursos del modo ONTAP con el proxy de la CLI. El proxy de la CLI es eficaz para el uso interactivo, pero la automatización puede ser más compleja. Terraform administra de forma coherente el ciclo de vida de los recursos de la nube, y puedes usarlo para administrar los recursos de NetApp Volumes y ONTAP.
Usa la tabla Descripción general de la administración de funciones para determinar qué proveedor usar.
El proveedor de Google administra los recursos a través de la API de NetApp Volumes.
El proveedor NetApp-ONTAP administra los recursos a través de las APIs de REST de ONTAP.
Por ejemplo, puedes crear un grupo de almacenamiento en modo ONTAP con el proveedor de Google, versión 7.27.0 o posterior. Luego, para crear un volumen en ese grupo en modo ONTAP, usa el proveedor NetApp-ONTAP, versión 2.6.0 o posterior.
Para obtener más información sobre la configuración y ejemplos, consulta la documentación del proveedor de NetApp-ONTAP.
Acciones de ONTAP permitidas
Cuando accedes a un grupo en modo ONTAP a través de la API o el proxy de la CLI, no tienes permisos completos y no puedes ejecutar todos los comandos de ONTAP. Esta restricción ayuda a proteger la integridad del sistema y evitar cambios en los recursos físicos subyacentes que administra el servicio.
En algunas APIs, el sistema filtra las cargas útiles de solicitud y respuesta a la API. Por ejemplo, debido a que NetApp Volumes factura por la capacidad lógica, el sistema bloquea los parámetros para configurar la capacidad física. Si envías un parámetro que no está permitido, la API devuelve un error.
Para obtener más información sobre cómo facturamos, consulta Facturación: capacidad lógica frente a física.
Comandos de ONTAP compatibles
Puedes administrar el modo ONTAP enviando comandos de ONTAP con el proxy de la CLI de ONTAP de Google Cloud CLI. NetApp Volumes admite la mayoría de los comandos para administrar SVM, LUN, volúmenes y funciones de ONTAP. Algunos comandos se bloquean para proteger la integridad del sistema o porque administran recursos físicos que no son relevantes en un servicio administrado, como NetApp Volumes.
Ejecutas comandos en el nivel de privilegio de administrador de ONTAP. Para cambiar el
nivel de privilegio a avanzado, agrega set advanced; o set -privilege advanced;
al comienzo del comando. Un conjunto limitado de comandos también admite el nivel de privilegio de diagnóstico
(diag), al que puedes acceder agregando set diag; al inicio
del comando. Estos cambios de privilegios no son persistentes.
Debido a que el proxy no es una shell interactiva, solo puedes ejecutar un comando a la vez. Esta limitación significa que el proxy no admite comandos interactivos que soliciten información adicional. Por ejemplo, no puedes crear un vserver (SVM) de CIFS o SMB que requiera credenciales de administrador de Active Directory. El proxy de la CLI tampoco admite el intercambio de tráfico entre clústeres porque es un comando interactivo. Para realizar esas operaciones, debes usar la API de REST de ONTAP.
En la siguiente tabla, se enumeran las familias de comandos, los comandos y las limitaciones admitidos del proxy de la CLI de ONTAP:
| Familia de comandos | Objetivo | Comandos compatibles | Notas |
|---|---|---|---|
| Clúster | Clústeres de intercambio de tráfico para SnapMirror y FlexCache, y muestra información seleccionada sobre el clúster | cluster peer: acceso completocluster show, identity show, date show, ha show, statistics show y time-service ntp server show: solo lectura |
El proxy de la CLI no admite el comando interactivo cluster peer create. En su lugar, usa la API de REST. Puedes usar otros comandos de cluster peer, como show. |
| Depuración | Admite el seguimiento de paquetes (tcpdump), el LUN y la solución de problemas de bloqueo | debug network tcpdump, debug san lun y debug lock persistence: acceso completo |
Todos los comandos de depuración permitidos requieren el nivel de privilegio diag. Estos son comandos de depuración comunes. |
| Evento | Crear filtros para enviar eventos de ONTAP de interés a destinos de SMTP o syslog | event catalog show y event log show: solo lecturaevent config, event filter y event notification: acceso completo |
Te permite registrar eventos en destinos personalizados. Puedes usar event log show para mostrar los eventos de registro por hora o tipo. |
| Trabajo | Administra trabajos de ONTAP a nivel de nodo y de clúster | job show, job schedule, job private, job stop y job resume: acceso completo |
|
| LUN | Crear y administrar LUN y grupos de iniciadores, y también importar LUN externos | lun create, lun bind y igroup: acceso completo |
Si bien se permite lun import, no es posible conectar discos externos a un sistema en modo ONTAP. |
| Red | Mostrar las configuraciones de puerto de red, interfaz, ruta y espacio de IP, ejecutar ping y traceroute a direcciones IP externas, y mostrar las conexiones de cliente por protocolo | network ping, network traceroute, network port interface, network ipspace y network connections: solo lectura |
|
| QoS | Crear y administrar grupos de políticas de QoS (QPG) y asignarlos a volúmenes La capacidad de procesamiento y las IOPS totales del grupo establecen el límite general. | qos policy-group create, qos policy-group modify y qos policy-group delete: acceso completoqos policy-group show: solo lecturavolume create -qos-policy-group y volume modify -qos-policy-group: adjunta un volumen a un QPG, muévelo a otro QPG o desconéctalo con none |
|
| Seguridad | Mostrar la configuración de auditoría, habilitar la función contra ransomware, y crear e instalar certificados | security audit: solo lecturasecurity anti-ransomware volume y security certificate: acceso completo |
Los parámetros de protección contra ransomware se pueden establecer cuando se crea el volumen. Solo puedes crear certificados de servidor y de cliente. |
| SnapLock | Administrar el reloj y los registros de SnapLock, y controlar las operaciones de conservación por motivos legales y de retención basada en eventos de SnapLock | snaplock compliance-clock y snaplock log: Acceso completo |
Usa el comando volume snaplock modify para configurar SnapLock en volúmenes individuales. Solo puedes administrar los comandos de SnapLock snaplock event-retention y snaplock legal-hold con la API de REST de ONTAP. |
| SnapMirror | Crea y administra relaciones de SnapMirror | snapmirror create, snapmirror initialize, snapmirror break y snapmirror resync: acceso completo |
|
| Estadísticas | Muestra estadísticas periódicas del sistema o crea muestras de estadísticas específicas | statistics samples, statistics start, statistics stop y statistics show-periodic: acceso completostatistics volume, statistics lun, statistics aggregate, statistics qtree y statistics SVM: solo lectura |
Muchos comandos necesitan el modo avanzado para especificar sus parámetros. |
| Sistema | Por lo general, no se admiten los comandos del sistema, pero se puede invocar la transmisión de archivos de rendimiento y AutoSupport | system node autosupport invoke y system node autosupport invoke-performance-archive: Acceso completo |
Los archivos de AutoSupport están disponibles para el equipo de asistencia de NetApp. |
| Volumen | Crea y administra volúmenes | volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock y snapshot: acceso completo |
El sistema administra automáticamente algunas funciones de volumen, como la generación de informes y la aplicación de medidas por incumplimiento de espacio lógico, y la garantía de espacio (ninguna). Establece la política de nivelación de volúmenes para usar la nivelación automática establecida a nivel del grupo. |
| Vserver | Administrar la SVM (vserver) para el acceso de archivos (SMB, NFS), bloques (iSCSI, NVMe) y objetos (S3) a los volúmenes Administrar las políticas que se usan para los volúmenes, como las políticas de exportación para NFS Habilitar las funciones de SVM, como el registro de auditoría (acceso a archivos), los grupos de coherencia, las políticas, los servicios de nombres (DNS, LDAP) y el antivirus (vscan) Intercambiar tráfico de SVM para SnapMirror y FlexCache |
vserver cifs create (unirse a un dominio de Active Directory), vserver nfs create, vserver iscsi create y vserver nvme create: acceso completovserver object-store-server: acceso completo |
Usa el comando vserver modify para establecer el idioma predeterminado, el estilo de seguridad y las políticas de instantáneas y cuotas para todos los volúmenes.vserver create no se admite en este momento.Los comandos de cambio de contraseña no se pueden ejecutar como interactivos y se deben especificar con parámetros de comando o con la API de REST. |
| Comandos heredados | timezone y version: Acceso completo |
Borra un grupo en modo ONTAP
Para borrar un grupo en modo ONTAP, primero debes borrar todos los volúmenes que contiene.