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/v1URN Google du pool de stockage : /projects/
PROJECT/locations/LOCATION/storagePools/POOL_NAMERemplacez 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.
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'URLhttps://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
namepour 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 :
Utilisez
ontap_fieldspour la sélection des champs : dans les pools NetApp Volumes en mode ONTAP, utilisez le paramètre de requêteontap_fields=au lieu du paramètre ONTAP standardfields=pour spécifier les champs demandés.Facultatif : Utilisez
jqpour extraire des champs : l'exemple suivant utilise l'outil Open Source jq pour extrairename(nom de la SVM) etaggregatesde 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 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 enveloppebody: {}pour NetApp Volumes.L'exemple suivant crée un volume nommé
myvolumed'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
tieringdans 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
Surveillez le job ONTAP.
La plupart des appels d'API ONTAP, tels que les opérations
POSTouPATCHqui 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
uuidrenvoyé :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
stateestsuccess, 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 completcluster 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 seuleevent 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 completqos policy-group show : lecture seulevolume 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 |
|
| Sécurité | Afficher la configuration d'audit, activer la fonctionnalité anti-ransomware, et créer et installer des certificats | security audit : lecture seulesecurity 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 completstatistics 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 completvserver 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.