Administra ONTAP en modo ONTAP

En esta página, se describe cómo administrar ONTAP en el modo ONTAP.

Por motivos de seguridad y registro, NetApp Volumes no permite conexiones directas a la LIF de administración de ONTAP. Por lo tanto, no puedes usar herramientas como SystemManager o SSH para administrar el sistema ONTAP 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

Tu versión de Google Cloud CLI debe ser al menos la 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 mostrará 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 a la CLI de ONTAP a través de SSH 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 en modo ONTAP de Flex Unified.

  • ONTAP-COMMAND: Es el comando de ONTAP que deseas ejecutar en el clúster o el grupo de almacenamiento.

  • PROJECT: el ID de tu 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/v1

  • URN de Google para el grupo de almacenamiento: /projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME

    Reemplaza la siguiente información:

    • PROJECT: Es el ID o número de tu proyecto.

    • LOCATION: Es 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

Al igual que todas las llamadas a las APIs de Google, esta llamada debe autenticarse. En el siguiente ejemplo de 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

Al igual que todas las llamadas a las APIs de Google, esta llamada debe autenticarse. En el siguiente ejemplo de 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.

  1. 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.

  2. 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 name para asignarle un nombre. La carga útil de creación de volúmenes requiere los nombres del agregado y de la máquina virtual de almacenamiento (SVM) que asignan los 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 los nombres de la SVM y el agregado, haz lo siguiente:

    1. Usa ontap_fields para la selección de campos: En los grupos en modo ONTAP de NetApp Volumes, usa el parámetro de consulta ontap_fields= en lugar del parámetro estándar fields= de ONTAP para especificar los campos solicitados.

    2. Opcional: Usajq para extraer campos: En el siguiente ejemplo, se usa la herramienta de código abierto jq para extraer name (nombre de SVM) y aggregates de la respuesta JSON, lo que resulta ú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"
}

  3. Ejecuta la llamada a la API de creación de volúmenes.

    Con el nombre agregado (aggr1) y el nombre del SVM (gcnv-7cf6ee41c1a94f0-svm-01), crea la carga útil final de creación de volumen y envía la llamada a la API. Ten en cuenta que la carga útil de la API de ONTAP debe estar incluida dentro de un sobre body: {} para NetApp Volumes.

    En el siguiente ejemplo, se crea un volumen llamado myvolume con 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 organización automática en niveles en la API de REST de ONTAP, incluye el objeto tiering JSON en el cuerpo de la solicitud:

    • Para establecer la política de 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 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 activo y escribir datos directamente en el nivel de 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

  4. Supervisa el trabajo de ONTAP.

    La mayoría de las llamadas a la API de ONTAP, como las operaciones POST o PATCH que 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 del 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 uuid que se devolvió:

    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 state es success, se crea el volumen.

    En este ejemplo de flujo de trabajo, se explica cómo 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 requerido 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 en modo ONTAP con el proxy de 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 tanto los recursos de NetApp Volumes como los de ONTAP.

Usa la tabla de Descripción general de la administración de funciones para determinar qué proveedor usar.

  • El proveedor 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 los 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 evita cambios en los recursos físicos subyacentes que administra el servicio.

En algunas APIs, el sistema filtra las cargas útiles de las solicitudes a la API y las respuestas. Por ejemplo, dado que NetApp Volumes factura 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 devolverá un error.

Para obtener más información sobre cómo facturamos, consulta Facturación: capacidad lógica versus 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 están bloqueados 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 a nivel de privilegios 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 comienzo del comando. Estos cambios de privilegios no son persistentes.

Como 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 servidor virtual (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 pares para SnapMirror y FlexCache, y muestra información seleccionada sobre el clúster cluster peer: Acceso completo

cluster 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 Compatibilidad con el seguimiento de paquetes (tcpdump), la 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 Crea filtros para enviar eventos de ONTAP de interés a destinos SMTP o syslog event catalog show y registro de eventos show: Solo lectura

event config, event filter y notificación de evento: 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 del nodo y del clúster job show, job schedule, job private, job stop y job resume: Acceso completo
LUN Crea y administra LUN y grupos de iniciadores, y también importa LUN externas lun create, lun bind y igroup: Acceso completo Si bien se permite la importación de LUN, no es posible conectar discos externos a un sistema en modo ONTAP.
Red Mostrar la configuración de puertos de red, interfaces, rutas y espacios de IP, ejecutar ping y traceroute a direcciones IP externas, y mostrar las conexiones de clientes por protocolo network ping, network traceroute, network port interface, network ipspace y network connections (solo lectura)
QoS Crea y administra grupos de políticas de QoS, y muestra el rendimiento de estos Todos los comandos de QoS (solo lectura) La configuración de QoS es de solo lectura.
Seguridad Mostrar la configuración de auditoría, habilitar la función contra ransomware y crear e instalar certificados Auditoría de seguridad: Solo lectura

Volumen de seguridad anti ransomware y certificado de seguridad: Acceso completo		 Los parámetros de protección contra ransomware se pueden establecer cuando se crea el volumen. Solo puedes crear certificados de cliente y servidor.
SnapLock Administrar el reloj y los registros de SnapLock, y controlar las operaciones de retención basadas en eventos y de suspensión legal 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 Mostrar estadísticas periódicas del sistema o crear muestras de estadísticas específicas statistics samples, statistics start, statistics stop y statistics show-periodic: Acceso completo

statistics 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 AutoSupport y del archivo de rendimiento. 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 Cómo crear y administrar volúmenes volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock, snapshot: Acceso completo El sistema administra automáticamente algunas capacidades de volumen, como la aplicación y la generación de informes 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 Administra la SVM (vserver) para el acceso a volúmenes de archivos (SMB, NFS), bloques (iSCSI, NVMe) y objetos (S3).

Administra las políticas que se usan para los volúmenes, como las políticas de exportación para NFS.

Habilita las funciones de SVM, como el registro de auditoría (acceso a archivos), los grupos de coherencia, la política, los servicios de nombres (DNS, LDAP) y el antivirus (vscan).

SVMs de igual nivel 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 completo

vserver 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.

Por el momento, no se admite vserver create.
Los comandos de cambio de contraseña no se pueden ejecutar de forma interactiva 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 del grupo.