Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Gérer ONTAP en mode ONTAP

Cette page explique comment gérer ONTAP en mode ONTAP.

Pour des raisons de sécurité et de journalisation, NetApp Volumes n'autorise pas les connexions directes à la LIF de gestion ONTAP. Par conséquent, vous ne pouvez pas utiliser d'outils tels que SystemManager ou SSH pour gérer directement le système ONTAP. Vous pouvez toutefois envoyer des opérations ONTAP à votre pool de stockage en mode ONTAP à l'aide des méthodes suivantes :

Proxy ONTAP CLI de la Google Cloud CLI
Une API de proxy Google pour les appels d'API REST ONTAP

Les outils de gestion, tels que Terraform, utilisent le proxy d'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 de 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 ONTAP CLI de la Google Cloud CLI

Bien que l'accès SSH direct à la CLI ONTAP ne soit pas disponible, vous pouvez envoyer des commandes CLI ONTAP à votre pool de stockage à l'aide de la 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 en mode ONTAP Flex Unified.
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 de proxy Google pour les appels d'API REST ONTAP

NetApp Volumes fournit un point de terminaison d'API Google pour chaque pool de stockage en mode FlexUnified 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 pour le 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 région pour les pools régionaux.
- POOL_NAME : nom de votre pool.
Chemin d'accès à l'API REST ONTAP : /ontap/ONTAP_REST_URL. Pour en savoir plus, consultez la documentation de référence de l'API REST ONTAP.

Lister 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, celui-ci 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, celui-ci 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 FlexUnified 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.

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.
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 la SVM et de l'agrégat :
1. Utiliser ontap_fields pour la sélection des champs : dans les pools en mode ONTAP de NetApp Volumes, 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 les champs. L'exemple suivant utilise l'outil Open Source jq pour extraire name (nom du 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"
}
```
Exécutez l'appel d'API de création de volume.

Avec le nom agrégé (aggr1) et le nom SVM (gcnv-7cf6ee41c1a94f0-svm-01), créez la charge utile finale de création de volume et envoyez l'appel d'API. Notez que la charge utile de l'API ONTAP doit être placée dans une enveloppe body: {} pour les 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 niveau 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 de seuil de refroidissement par défaut est de 31 jours.
Pour contourner le niveau actif et écrire des données directement dans le niveau cloud sur les volumes en lecture/écriture, utilisez le proxy Google Cloud CLI ONTAP 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
```

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. Ces appels renvoient plutôt une ressource de job ONTAP, comme indiqué dans l'exemple de création de volume.

Exemple de réponse à une offre d'emploi :

{
  "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'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 state est défini sur 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 montre é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'à la création de la ressource. 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 obtenir des 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 CLI, vous ne disposez pas de toutes les autorisations et vous 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 toute modification 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 d'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 ONTAP CLI 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 d'accès aux diagnostics (diag). Pour y accéder, ajoutez set diag; au début de votre commande. Ces changements de privilèges ne sont pas permanents.

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 serveur virtuel CIFS ou SMB (SVM) 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 liste les familles de commandes, les commandes et les limites du proxy CLI ONTAP :

Famille de commandes	Objectif	Commandes compatibles	Remarques
Cluster	Clusters pairs pour SnapMirror et FlexCache, et affichage de certaines informations sur le cluster	cluster peer : accès complet cluster show, identity show, date show, ha show, statistics show et time-service ntp server show : accès en lecture seule	Le proxy 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`, comme `show`.
Déboguer	Prise en charge du traçage de paquets (tcpdump), des LUN et du dépannage des verrous	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 qui vous intéressent vers des destinations SMTP ou syslog	event catalog show et journal des événements show : accès en lecture seule event config, event filter et notification d'événement : accès complet	Vous permet d'enregistrer 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	L'importation de LUN est autorisée, mais il n'est pas possible de connecter des disques étrangers à un système en mode ONTAP.
Réseau	Afficher les configurations de port réseau, d'interface, de route et d'espace d'adresses IP, exécuter ping et traceroute vers des adresses IP externes, et afficher les connexions client par protocole	ping réseau, traceroute réseau, interface de port réseau, espace d'adresses IP réseau et connexions réseau : accès en lecture seule
QoS	Créer et gérer des groupes de règles de qualité de service, et afficher leurs performances	Toutes les commandes QoS (lecture seule)	Les paramètres QoS sont en lecture seule.
Sécurité	Afficher la configuration d'audit, activer la fonctionnalité anti-ransomware, et créer et installer des certificats	Audit de sécurité : accès en lecture seule Volume de sécurité anti-ransomware et certificat de sécurité : accès complet	Vous pouvez définir des paramètres anti-ransomware lorsque vous créez le 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 et d'obligation de conservation basées sur les événements 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 : accès en 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 la transmission AutoSupport et de l'archive des performances peut être invoquée.	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, snapshot : accès complet	Certaines fonctionnalités liées au 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 automatique du niveau de volume pour utiliser la hiérarchisation automatique définie au niveau du pool.
Vserver	Gérez le SVM (vserver) pour l'accès aux volumes aux niveaux des fichiers (SMB, NFS), des blocs (iSCSI, NVMe) et des objets (S3). Gérez les règles utilisées pour les volumes, telles que les règles d'exportation pour NFS. Activez les fonctionnalités 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). Appairez les SVM pour SnapMirror et FlexCache.	vserver cifs create (joindre 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 par défaut, le style de sécurité, ainsi que les règles de quota et de snapshot pour tous les volumes. La commande vserver create n'est pas compatible pour le moment. Les commandes de modification du mot de passe ne peuvent pas être exécutées de manière interactive. Elles 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 du pool.