Gérer ONTAP en mode ONTAP

Google Cloud NetApp Volumes vous permet de gérer les ressources ONTAP dans un pool de stockage en mode ONTAP en envoyant des opérations via des proxys Google Cloud .

Pour des raisons de sécurité et de journalisation, NetApp Volumes n'autorise pas les connexions directes à la LIF de gestion ONTAP. Vous ne pouvez donc pas utiliser directement des outils tels que SystemManager ou SSH. À la place, vous pouvez envoyer des opérations ONTAP à votre pool de stockage en mode ONTAP à l'aide des méthodes suivantes :

Les outils de gestion, tels que Terraform, utilisent le proxy de l'API Google pour gérer les ressources ONTAP.

Avant de commencer

Votre version de Google Cloud CLI doit être au moins 559.0.0 pour gérer les opérations ONTAP pour votre pool de stockage en mode ONTAP. Si votre version est plus ancienne, Google Cloud CLI renvoie une erreur indiquant que la commande ou l'option n'est pas définie.

Utiliser le proxy de la CLI ONTAP de Google Cloud CLI

Bien que l'accès SSH direct à la CLI ONTAP ne soit pas disponible, vous pouvez envoyer des commandes de la CLI ONTAP à votre pool de stockage à l'aide de Google Cloud CLI.

gcloud

Exécutez une commande ONTAP :

gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \
  --location=LOCATION

Remplacez les informations suivantes :

  • POOL-NAME : nom du pool de stockage Flex Unified en mode ONTAP.

  • ONTAP-COMMAND : commande ONTAP que vous souhaitez exécuter sur le cluster ou le pool de stockage.

  • PROJECT : ID de votre projet.

  • LOCATION : emplacement de votre pool de stockage.

Utiliser une API proxy Google pour les appels d'API REST ONTAP

NetApp Volumes fournit un point de terminaison d'API Google pour chaque pool de stockage Flex Unified en mode ONTAP, ce qui vous permet d'envoyer des appels d'API REST ONTAP au cluster ONTAP sous-jacent. Cela vous permet de contrôler les fonctionnalités ONTAP à l'aide d'API.

Les appels au proxy ONTAP doivent utiliser le format d'URL suivant :

  https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
 

Cette URL se compose des éléments suivants :

  • URL de référence : https://netapp.googleapis.com/v1

  • URN Google du pool de stockage : /projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME

    Remplacez les informations suivantes :

    • PROJECT : ID ou numéro de votre projet.

    • LOCATION : nom de la zone pour les pools zonaux ou de la région pour les pools régionaux.

    • POOL_NAME : nom de votre pool.

  • Chemin de l'API REST ONTAP : /ontap/ONTAP_REST_URL. Pour en savoir plus, consultez la documentation de référence de l'API REST ONTAP.

Répertorier tous les volumes d'un pool de stockage

L'exemple suivant montre l'URL complète permettant de lister tous les volumes du pool de stockage mypool dans us-central1-a du projet myproject.

https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes

Comme tous les appels d'API Google, cet appel doit être authentifié. L'exemple de CLI suivant récupère un jeton d'API, puis appelle l'URL à l'aide de curl pour lister tous les volumes du pool :

   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"
  

Lister tous les instantanés d'un volume

L'exemple suivant montre l'URL complète permettant de lister tous les instantanés du pool de stockage mypool et du volume volume-uuid dans us-central1-a du projet myproject.

https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots

Comme tous les appels d'API Google, cet appel doit être authentifié. L'exemple de CLI suivant récupère un jeton d'API, puis appelle l'URL à l'aide de curl pour lister tous les instantanés du volume :

   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"
  

Créer un volume

Cette section explique comment créer un volume nommé myvolume dans un pool de stockage Flex Unified en mode ONTAP existant, identifié par l'URN /projects/myproject/locations/us-central1-a/storagePools/mypool, à l'aide de l'API REST ONTAP.

Pour créer un volume, consultez la documentation en ligne de l'API REST ONTAP. Dans la documentation, accédez à la section Stockage, puis développez Gérer les volumes de stockage. Cette section fournit plusieurs exemples.

Suivez les instructions ci-dessous pour créer un volume.

  1. Déterminez le point de terminaison de l'API REST ONTAP.

    En utilisant l'exemple de base dans NetApp Volumes, le point de terminaison de l'API ONTAP requis est /api/storage/volumes. Ce point de terminaison crée l'URL https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.

  2. Créez la charge utile de la requête.

    Utilisez l'exemple de charge utile de la documentation ONTAP pour l'adapter à votre environnement spécifique. Exemple :

    {
      "name": "vol1",
      "aggregates": [
        {
          "name": "aggr1"
        }
      ],
      "svm": {
        "name": "vs1"
      }
    }
    

    Lorsque vous créez un volume, utilisez le champ name pour lui attribuer un nom. La charge utile de création de volume nécessite les noms de l'agrégat et de la machine virtuelle de stockage (SVM) attribués par NetApp Volumes lors de la création du pool en mode ONTAP. En mode ONTAP, chaque pool de stockage possède une SVM et un agrégat de stockage. Ces informations peuvent être récupérées en interrogeant ONTAP pour toutes les SVM.

    Pour récupérer les noms de SVM et d'agrégat :

    1. Utilisez ontap_fields pour la sélection des champs : dans les pools NetApp Volumes en mode ONTAP, utilisez le paramètre de requête ontap_fields= au lieu du paramètre ONTAP standard fields= pour spécifier les champs demandés.

    2. Facultatif : Utilisezjq pour extraire des champs : l'exemple suivant utilise l'outil Open Source jq pour extraire name (nom de la SVM) et aggregates de la réponse JSON, ce qui est utile pour le traitement dans les scripts 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}'
      

      Exemple de réponse :

      {
       "name": "gcnv-7cf6ee41c1a94f0-svm-01",
       "aggregates": "aggr1"
      }
      
  3. Exécutez l'appel d'API de création de volume.

    Avec le nom de l'agrégat (aggr1) et le nom de la SVM (gcnv-7cf6ee41c1a94f0-svm-01), créez la charge utile de création de volume finale et envoyez l'appel d'API. Notez que la charge utile de l'API ONTAP doit être encapsulée dans une enveloppe body: {} pour NetApp Volumes.

    L'exemple suivant crée un volume nommé myvolume d'une taille de 2 Go :

    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 création de volumes est compatible avec de nombreux paramètres facultatifs, tels que size. Par exemple, la charge utile spécifie une taille de 2 Go. La page de documentation de la ressource liste tous les paramètres disponibles, y compris les paramètres obligatoires et facultatifs. Il fournit également des exemples détaillés de charges utiles et de corps de réponse.

    Pour configurer la hiérarchisation automatique dans l'API REST ONTAP, incluez l'objet JSON tiering dans le corps de la requête :

    • Pour définir la règle de hiérarchisation du volume sur all, utilisez "tiering": {"policy": "all"}.

    • Facultatif : Pour configurer les jours de refroidissement, utilisez "tiering": {"policy": "auto", "min_cooling_days": 31}.

      Vous pouvez spécifier un seuil de refroidissement compris entre 2 et 183 jours dans le champ min_cooling_days. La valeur par défaut du seuil de refroidissement est de 31 jours.

    Pour contourner le niveau chaud et écrire des données directement dans le niveau cloud sur des volumes en lecture-écriture (RW), utilisez le proxy de la CLI ONTAP de Google Cloud CLI avec des droits avancés :

    set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
  4. Surveillez le job ONTAP.

    La plupart des appels d'API ONTAP, tels que les opérations POST ou PATCH qui créent ou mettent à jour des ressources, ne s'exécutent pas de manière synchrone. À la place, ces appels renvoient une ressource de job ONTAP, comme illustré dans l'exemple de création de volume.

    Exemple de réponse de job :

    {
      "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"
        }
      }
    }
    

    Pour vérifier l'état du job, interrogez la ressource de job à l'aide de l'élément uuid renvoyé :

    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"
    

    Exemple de réponse :

    {
      "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 la valeur de state est success, le volume est créé.

    Cet exemple de workflow vous explique comment rechercher des actions ONTAP dans la documentation de l'API REST ONTAP. Il vous explique également comment créer le format de charge utile requis et l'envoyer au pool de stockage à l'aide d'une API Google. Enfin, il montre comment surveiller un job ONTAP jusqu'à ce que la ressource soit créée. Cette approche vous permet de contrôler la plupart des paramètres ONTAP de votre pool de stockage.

Utiliser Terraform pour gérer le mode ONTAP

Vous pouvez gérer les ressources en mode ONTAP à l'aide du proxy CLI. Le proxy CLI est efficace pour une utilisation interactive, mais l'automatisation peut être plus complexe. Terraform gère de manière cohérente le cycle de vie des ressources cloud. Vous pouvez l'utiliser pour gérer les ressources NetApp Volumes et ONTAP.

Utilisez le tableau Présentation de la gestion des fonctionnalités pour déterminer le fournisseur à utiliser.

  • Le fournisseur Google gère les ressources via l'API NetApp Volumes.

  • Le fournisseur NetApp-ONTAP gère les ressources via les API REST ONTAP.

Par exemple, vous créez un pool de stockage en mode ONTAP à l'aide du fournisseur Google, version 7.27.0 ou ultérieure. Ensuite, pour créer un volume dans ce pool en mode ONTAP, vous utilisez le fournisseur NetApp-ONTAP, version 2.6.0 ou ultérieure.

Pour en savoir plus sur la configuration et les exemples, consultez la documentation du fournisseur NetApp-ONTAP.

Actions ONTAP autorisées

Lorsque vous accédez à un pool en mode ONTAP via l'API ou le proxy de la CLI, vous ne disposez pas d'autorisations complètes et ne pouvez pas exécuter toutes les commandes ONTAP. Cette restriction permet de protéger l'intégrité du système et d'empêcher les modifications des ressources physiques sous-jacentes gérées par le service.

Pour certaines API, le système filtre les charges utiles des requêtes et des réponses API. Par exemple, comme NetApp Volumes facture la capacité logique, le système bloque les paramètres de configuration de la capacité physique. Si vous envoyez un paramètre non autorisé, l'API renvoie une erreur.

Pour en savoir plus sur la facturation, consultez Facturation : capacité logique ou physique.

Commandes ONTAP compatibles

Vous pouvez gérer le mode ONTAP en envoyant des commandes ONTAP à l'aide du proxy de la CLI ONTAP de Google Cloud CLI. NetApp Volumes est compatible avec la plupart des commandes permettant de gérer les SVM, les LUN, les volumes et les fonctionnalités ONTAP. Certaines commandes sont bloquées pour protéger l'intégrité du système ou parce qu'elles gèrent des ressources physiques qui ne sont pas pertinentes dans un service géré tel que NetApp Volumes.

Vous exécutez des commandes au niveau des droits d'administrateur ONTAP. Pour passer au niveau de privilège avancé, ajoutez set advanced; ou set -privilege advanced; au début de votre commande. Un ensemble limité de commandes est également compatible avec le niveau de privilège de diagnostic (diag), auquel vous pouvez accéder en ajoutant set diag; au début de votre commande. Ces changements de privilèges ne sont pas persistants.

Comme le proxy n'est pas un shell interactif, vous ne pouvez exécuter qu'une seule commande à la fois. Cette limitation signifie que le proxy n'est pas compatible avec les commandes interactives qui demandent des informations supplémentaires. Par exemple, vous ne pouvez pas créer de vserver (SVM) CIFS ou SMB nécessitant des identifiants d'administrateur Active Directory. Le proxy CLI n'est pas non plus compatible avec l'appairage de clusters, car il s'agit d'une commande interactive. Pour effectuer ces opérations, vous devez utiliser l'API REST ONTAP.

Le tableau suivant répertorie les familles de commandes, les commandes et les limites du proxy de la CLI ONTAP :

Famille de commandes Objectif Commandes compatibles Remarques
Cluster Clusters pairs pour SnapMirror, FlexCache et affichage d'informations sélectionnées sur le cluster cluster peer : accès complet

cluster show, identity show, date show, ha show, statistics show et time-service ntp server show : lecture seule
Le proxy de la CLI n'est pas compatible avec la commande interactive cluster peer create. Utilisez plutôt l'API REST. Vous pouvez utiliser d'autres commandes cluster peer, telles que show.
Déboguer Prise en charge du traçage de paquets (tcpdump), des LUN et du dépannage des verrouillages debug network tcpdump, debug san lun et debug lock persistence : accès complet Toutes les commandes de débogage autorisées nécessitent le niveau de privilège diag. Il s'agit de commandes de débogage courantes.
Événement Créer des filtres pour envoyer les événements ONTAP d'intérêt vers des destinations SMTP ou syslog event catalog show et event log show : lecture seule

event config, event filter et event notification : accès complet
Permet de consigner des événements dans des destinations personnalisées. Vous pouvez utiliser event log show pour afficher les événements de journaux par heure ou par type.
Job Gérer les tâches ONTAP au niveau du nœud et du cluster job show, job schedule, job private, job stop et job resume : accès complet
LUN Créer et gérer des LUN et des groupes d'initiateurs, et importer des LUN externes lun create, lun bind et igroup : accès complet Bien que lun import soit autorisé, il n'est pas possible de connecter des disques étrangers à un système en mode ONTAP.
Réseau Afficher les configurations de port, d'interface, de route et d'espace IP du réseau, exécuter des commandes ping et traceroute vers des adresses IP externes, et afficher les connexions client par protocole network ping, network traceroute, network port interface, network ipspace et network connections - lecture seule
QoS Créez et gérez des groupes de règles de QoS, puis attribuez-les à des volumes. Le débit total et les IOPS du pool définissent le plafond global. qos policy-group create, qos policy-group modify et qos policy-group delete : accès complet

qos policy-group show : lecture seule

volume create -qos-policy-group et volume modify -qos-policy-group : associer un volume à un QPG, le déplacer vers un autre QPG ou le dissocier avec none
  • qos policy-group create nécessite -vserver.
  • Si vous omettez -is-shared, le QPG est partagé.
  • -vserver n'est pas nécessaire pour qos policy-group modify ou qos policy-group delete.
  • qos policy-group delete ne fonctionne que si aucun volume n'est associé. Commencez par les dissocier avec volume modify -qos-policy-group none.
  • La règle SVM SVM-qos-policy reflète le débit total et les IOPS du pool. Pour modifier ces totaux, utilisez gcloud netapp storage-pools update --total-throughput ou --total-iops, et non la ligne de commande ONTAP.
Sécurité Afficher la configuration d'audit, activer la fonctionnalité anti-ransomware, et créer et installer des certificats security audit : lecture seule

security anti-ransomware volume et security certificate : accès complet
Les paramètres anti-ransomware peuvent être définis lors de la création du volume. Vous ne pouvez créer que des certificats de serveur et de client.
SnapLock Gérer l'horloge et les journaux SnapLock, et contrôler les opérations de conservation basée sur les événements et d'obligation de conservation SnapLock snaplock compliance-clock et snaplock log : accès complet Utilisez la commande volume snaplock modify pour configurer SnapLock sur des volumes individuels. Vous ne pouvez gérer les commandes SnapLock snaplock event-retention et snaplock legal-hold qu'à l'aide de l'API REST ONTAP.
SnapMirror Créer et gérer des relations SnapMirror snapmirror create, snapmirror initialize, snapmirror break et snapmirror resync : accès complet
Statistiques Afficher des statistiques système périodiques ou créer des échantillons de statistiques spécifiques statistics samples, statistics start, statistics stop et statistics show-periodic : accès complet

statistics volume, statistics lun, statistics aggregate, statistics qtree et statistics SVM : lecture seule
De nombreuses commandes nécessitent le mode avancé pour spécifier leurs paramètres.
Système Les commandes système ne sont généralement pas prises en charge, mais AutoSupport et la transmission d'archives de performances peuvent être appelés. system node autosupport invoke et system node autosupport invoke-performance-archive : accès complet Les fichiers AutoSupport sont disponibles pour l'assistance NetApp.
Volume Créer et gérer des volumes volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock et snapshot : accès complet Certaines fonctionnalités de volume, telles que la création de rapports/l'application de l'espace logique et la garantie d'espace (aucune), sont gérées automatiquement par le système. Définissez la règle de hiérarchisation des volumes pour utiliser la hiérarchisation automatique définie au niveau du pool.
Vserver Gérer la SVM (vserver) pour l'accès aux volumes par fichier (SMB, NFS), par bloc (iSCSI, NVMe) et par objet (S3).

Gérer les règles utilisées pour les volumes, telles que les règles d'exportation pour NFS.

Activer les fonctionnalités de SVM telles que la journalisation d'audit (accès aux fichiers), les groupes de cohérence, les règles, les services de noms (DNS, LDAP) et l'antivirus (vscan).

Appairer des SVM pour SnapMirror et FlexCache.
vserver cifs create (rejoindre un domaine Active Directory), vserver nfs create, vserver iscsi create et vserver nvme create : accès complet

vserver object-store-server : accès complet
Utilisez la commande vserver modify pour définir la langue, le style de sécurité, ainsi que les règles d'instantané et de quota par défaut pour tous les volumes.

vserver create n'est pas compatible pour le moment.
Les commandes de modification de mot de passe ne peuvent pas être exécutées de manière interactive et doivent être spécifiées à l'aide de paramètres de commande ou de l'API REST.
Anciennes commandes timezone et version : accès complet

Supprimer un pool en mode ONTAP

Pour supprimer un pool en mode ONTAP, vous devez d'abord supprimer tous les volumes qu'il contient.