Mit Google Cloud NetApp Volumes können Sie ONTAP-Ressourcen in einem Speicherpool im ONTAP-Modus verwalten, indem Sie Vorgänge über Google Cloud -Proxys senden.
Aus Sicherheits- und Logging-Gründen lässt NetApp Volumes keine direkten Verbindungen zur ONTAP-Verwaltungs-LIF zu. Daher können Sie Tools wie SystemManager oder SSH nicht direkt verwenden. Stattdessen können Sie ONTAP-Vorgänge mit den folgenden Methoden an Ihren Speicherpool im ONTAP-Modus senden:
Die Managementtools wie Terraform verwenden den Google API-Proxy, um ONTAP-Ressourcen zu verwalten.
Hinweis
Sie benötigen mindestens die Google Cloud CLI-Version 559.0.0, um ONTAP-Vorgänge für Ihren Speicherpool im ONTAP-Modus zu verwalten. Wenn Ihre Version älter ist, gibt die Google Cloud CLI einen Fehler zurück, dass der Befehl oder das Flag nicht definiert ist.
Google Cloud CLI-ONTAP-CLI-Proxy verwenden
Ein direkter SSH-Zugriff auf die ONTAP-Befehlszeile ist nicht möglich. Sie können jedoch ONTAP-Befehlszeilenbefehle mit der Google Cloud CLI an Ihren Speicherpool senden.
gcloud
Führen Sie einen ONTAP-Befehl aus:
gcloud netapp storage-pools execute POOL-NAME ONTAP-COMMAND --project PROJECT \ --location=LOCATION
Ersetzen Sie die folgenden Informationen:
POOL-NAME: der Name des Flex Unified ONTAP-Modus-Speicherpools.ONTAP-COMMAND: der ONTAP-Befehl, den Sie auf dem Cluster oder Speicherpool ausführen möchten.PROJECT: Ihre Projekt-ID.LOCATION: der Standort Ihres Speicherpools.
Google-Proxy-API für ONTAP REST API-Aufrufe verwenden
NetApp Volumes stellt für jeden Flex Unified ONTAP-Modus-Speicherpool einen Google API-Endpunkt bereit, über den Sie ONTAP REST API-Aufrufe an den zugrunde liegenden ONTAP-Cluster senden können. So können Sie ONTAP-Funktionen über APIs steuern.
Aufrufe des ONTAP-Proxys müssen das folgende URL-Format verwenden:
https://netapp.googleapis.com/v1/projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME/ontap/ONTAP_REST_URL
Diese URL besteht aus den folgenden Elementen:
Baseline-URL:
https://netapp.googleapis.com/v1Google-URN für den Speicherpool: /projects/
PROJECT/locations/LOCATION/storagePools/POOL_NAMEErsetzen Sie die folgenden Informationen:
PROJECT: die Projekt-ID bzw. Projektnummer.LOCATION: der Zonenname für zonale Pools oder die Region für regionale Pools.POOL_NAME: der Name des Pools.
ONTAP REST API-Pfad: /ontap/
ONTAP_REST_URL. Weitere Informationen finden Sie in der Referenz zur ONTAP REST API.
Alle Volumes eines Speicherpools auflisten
Das folgende Beispiel zeigt die vollständige URL, um alle Volumes für den Speicherpool mypool in us-central1-a im Projekt myproject aufzulisten.
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes
Wie alle Google API-Aufrufe muss auch dieser Aufruf authentifiziert werden. Im folgenden CLI-Beispiel wird ein API-Token abgerufen und dann die URL mit curl aufgerufen, um alle Volumes im Pool aufzulisten:
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"
Alle Snapshots eines Volumes auflisten
Das folgende Beispiel zeigt die vollständige URL zum Auflisten aller Snapshots für den Speicherpool mypool und das Volume volume-uuid in us-central1-a im Projekt myproject.
https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes/volume-uuid/snapshots
Wie alle Google API-Aufrufe muss auch dieser Aufruf authentifiziert werden. Im folgenden CLI-Beispiel wird ein API-Token abgerufen und dann die URL mit curl aufgerufen, um alle Snapshots für das Volume aufzulisten:
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"
Volume erstellen
In diesem Abschnitt wird gezeigt, wie Sie mit der ONTAP REST API ein Volume mit dem Namen myvolume in einem vorhandenen Flex Unified ONTAP-Speicherpool erstellen, der durch den URN /projects/myproject/locations/us-central1-a/storagePools/mypool identifiziert wird.
Informationen zum Erstellen eines Volumes finden Sie in der Online-Dokumentation zur ONTAP REST API. Gehen Sie in der Dokumentation zum Abschnitt Speicher und maximieren Sie Speichervolumes verwalten. In diesem Abschnitt finden Sie mehrere Beispiele.
So erstellen Sie ein Volume:
Bestimmen Sie den ONTAP REST API-Endpunkt.
Im einfachen Beispiel in NetApp Volumes lautet der erforderliche ONTAP API-Endpunkt
/api/storage/volumes. Dieser Endpunkt erstellt die URL:https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes.Erstellen Sie die Anfragenutzlast.
Verwenden Sie die Beispielnutzlast aus der ONTAP-Dokumentation, um sie an Ihre spezifische Umgebung anzupassen. Beispiel:
{ "name": "vol1", "aggregates": [ { "name": "aggr1" } ], "svm": { "name": "vs1" } }Verwenden Sie beim Erstellen eines Volumes das Feld
name, um den Volume-Namen zuzuweisen. Für die Nutzlast zur Volume-Erstellung sind die Namen des Aggregats und der Storage Virtual Machine (SVM) erforderlich, die von NetApp Volumes während der Erstellung des Pools im ONTAP-Modus zugewiesen wurden. Im ONTAP-Modus hat jeder Speicherpool eine SVM und ein Speicheraggregat. Diese Informationen können durch Abfragen von ONTAP für alle SVMs abgerufen werden.So rufen Sie die SVM- und Aggregatnamen ab:
Verwenden Sie
ontap_fieldsfür die Feldauswahl: Verwenden Sie in NetApp Volumes-Pools im ONTAP-Modus den Abfrageparameterontap_fields=anstelle des Standard-ONTAP-Parametersfields=, um die angeforderten Felder anzugeben.Optional: Verwenden Sie
jq, um Felder zu extrahieren: Im folgenden Beispiel wird das Open-Source-Tool jq verwendet, umname(SVM-Name) undaggregatesaus der JSON-Antwort zu extrahieren. Dies ist nützlich für die Verarbeitung in Shell-Skripts.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}'Beispielantwort:
{ "name": "gcnv-7cf6ee41c1a94f0-svm-01", "aggregates": "aggr1" }
Führen Sie den API-Aufruf zur Volume-Erstellung aus.
Erstellen Sie mit dem Aggregatnamen (
aggr1) und dem SVM-Namen (gcnv-7cf6ee41c1a94f0-svm-01) die endgültige Nutzlast für die Volume-Erstellung und senden Sie den API-Aufruf. Beachten Sie, dass die ONTAP API-Nutzlast für NetApp Volumes in einembody: {}-Umschlag enthalten sein muss.Im folgenden Beispiel wird ein Volume mit dem Namen
myvolumeund einer Größe von 2 GB erstellt: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" } }'Die Volume-Erstellung unterstützt viele optionale Parameter, z. B.
size. In der Nutzlast wird beispielsweise eine Größe von 2 GB angegeben. Auf der Dokumentationsseite der Ressource sind alle verfügbaren Parameter aufgeführt, einschließlich erforderlicher und optionaler Parameter. Außerdem finden Sie hier detaillierte Beispiele für Nutzlasten und Antworttexten.Wenn Sie das automatische Tiering in der ONTAP REST API konfigurieren möchten, fügen Sie das JSON-Objekt
tieringin den Anfragetext ein:Verwenden Sie
"tiering": {"policy": "all"}, um die Tiering-Richtlinie des Volumes aufallfestzulegen.Optional: Verwenden Sie
"tiering": {"policy": "auto", "min_cooling_days": 31}, um die Cooling-Tage zu konfigurieren.Sie können im Feld
min_cooling_dayseinen Schwellenwert für die Abkühlung zwischen 2 und 183 Tagen angeben. Der Standardwert für den Kühlungsschwellenwert beträgt 31 Tage.
Wenn Sie die Hot-Tier umgehen und Daten direkt in die Cloud-Tier auf Lese-/Schreib-Volumes (RW) schreiben möchten, verwenden Sie den Google Cloud CLI ONTAP CLI-Proxy mit erweiterten Berechtigungen:
set -privilege advanced; volume modify -vserver SVM_NAME -volume VOLUME_NAME -tiering-policy all -is-cloud-write-enabled true
Überwachen Sie den ONTAP-Job.
Die meisten ONTAP API-Aufrufe, z. B.
POST- oderPATCH-Vorgänge, die Ressourcen erstellen oder aktualisieren, werden nicht synchron ausgeführt. Stattdessen geben diese Aufrufe eine ONTAP-Jobressource zurück, wie im Beispiel für die Volume-Erstellung gezeigt.Beispiel für eine Jobantwort:
{ "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" } } }Fragen Sie die Jobressource mit der zurückgegebenen
uuidab, um den Status des Jobs zu prüfen: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"
Beispielantwort:
{ "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" } } }Wenn
stateden Wertsuccesshat, wird das Volume erstellt.In diesem Beispielworkflow wird gezeigt, wie Sie ONTAP-Aktionen in der ONTAP REST API-Dokumentation nachschlagen. Außerdem erfahren Sie, wie Sie das erforderliche Nutzlastformat erstellen und mit einer Google API an den Speicherpool senden. Abschließend wird gezeigt, wie Sie einen ONTAP-Job überwachen, bis die Ressource erstellt wurde. Mit diesem Ansatz können Sie die meisten ONTAP-Einstellungen für Ihren Speicherpool steuern.
ONTAP-Modus mit Terraform verwalten
Sie können ONTAP-Modus-Ressourcen mit dem CLI-Proxy verwalten. Der CLI-Proxy ist für die interaktive Nutzung effektiv, die Automatisierung kann jedoch komplexer sein. Terraform verwaltet den Lebenszyklus von Cloud-Ressourcen konsistent. Sie können damit sowohl NetApp Volumes- als auch ONTAP-Ressourcen verwalten.
Anhand der Tabelle Übersicht über die Funktionsverwaltung können Sie feststellen, welchen Anbieter Sie verwenden sollten.
Der Google-Anbieter verwaltet Ressourcen über die NetApp Volumes API.
Der NetApp-ONTAP-Anbieter verwaltet Ressourcen über ONTAP REST APIs.
Sie erstellen beispielsweise einen Speicherpool im ONTAP-Modus mit dem Google-Anbieter, Version 7.27.0 oder höher. Um dann ein Volume in diesem Pool im ONTAP-Modus zu erstellen, verwenden Sie den NetApp-ONTAP-Anbieter, Version 2.6.0 oder höher.
Weitere Informationen zur Einrichtung und Beispiele finden Sie in der Dokumentation zum NetApp-ONTAP-Anbieter.
Zulässige ONTAP-Aktionen
Wenn Sie über die API oder den CLI-Proxy auf einen Pool im ONTAP-Modus zugreifen, haben Sie keine vollständigen Berechtigungen und können nicht alle ONTAP-Befehle ausführen. Diese Einschränkung trägt dazu bei, die Systemintegrität zu schützen und Änderungen an den zugrunde liegenden physischen Ressourcen zu verhindern, die vom Dienst verwaltet werden.
Bei einigen APIs filtert das System die Nutzlasten von API-Anfragen und -Antworten. Da NetApp Volumes beispielsweise die logische Kapazität in Rechnung stellt, blockiert das System Parameter zum Konfigurieren der physischen Kapazität. Wenn Sie einen nicht zulässigen Parameter senden, gibt die API einen Fehler zurück.
Weitere Informationen zur Abrechnung finden Sie unter Abrechnung: logische im Vergleich zu physischer Kapazität.
Unterstützte ONTAP-Befehle
Sie können den ONTAP-Modus verwalten, indem Sie ONTAP-Befehle über den Google Cloud CLI ONTAP CLI-Proxy senden. NetApp Volumes unterstützt die meisten Befehle zum Verwalten von SVMs, LUNs, Volumes und ONTAP-Funktionen. Einige Befehle werden blockiert, um die Systemintegrität zu schützen oder weil sie physische Ressourcen verwalten, die in einem verwalteten Dienst wie NetApp Volumes nicht relevant sind.
Sie führen Befehle auf der ONTAP-Administratorberechtigungsebene aus. Wenn Sie die Berechtigungsstufe auf „Erweitert“ ändern möchten, fügen Sie am Anfang des Befehls set advanced; oder set -privilege advanced; hinzu. Eine begrenzte Anzahl von Befehlen unterstützt auch die Berechtigungsstufe „Diagnose“ (diag). Sie können darauf zugreifen, indem Sie set diag; am Anfang des Befehls hinzufügen. Diese Berechtigungsänderungen sind nicht dauerhaft.
Da der Proxy keine interaktive Shell ist, können Sie jeweils nur einen Befehl ausführen. Diese Einschränkung bedeutet, dass der Proxy keine interaktiven Befehle unterstützt, die zusätzliche Informationen anfordern. Sie können beispielsweise keinen CIFS- oder SMB-vServer (SVM) erstellen, für den Active Directory-Administratoranmeldedaten erforderlich sind. Der CLI-Proxy unterstützt auch kein Cluster-Peering, da es sich um einen interaktiven Befehl handelt. Für diese Vorgänge müssen Sie die ONTAP REST API verwenden.
In der folgenden Tabelle sind die unterstützten Befehlsfamilien, Befehle und Einschränkungen des ONTAP-CLI-Proxys aufgeführt:
| Befehlsfamilie | Zweck | Unterstützte Befehle | Hinweise |
|---|---|---|---|
| Cluster | Peer-Cluster für SnapMirror, FlexCache und ausgewählte Informationen zum Cluster anzeigen | cluster peer – Vollzugriffcluster show, identity show, date show, ha show, statistics show und time-service ntp server show – Lesezugriff |
Der CLI-Proxy unterstützt den interaktiven Befehl cluster peer create nicht. Verwenden Sie stattdessen die REST API. Sie können auch andere cluster peer-Befehle wie show verwenden. |
| Fehler beheben | Unterstützung für Paket-Tracing (tcpdump), LUN und Fehlerbehebung bei Sperren | debug network tcpdump, debug san lun und debug lock persistence – Vollzugriff |
Für alle zulässigen Debug-Befehle ist die Berechtigungsstufe diag erforderlich. Dies sind gängige Debug-Befehle. |
| Ereignis | Filter erstellen, um relevante ONTAP-Ereignisse an SMTP- oder Syslog-Ziele zu senden | event catalog show und event log show – Lesezugriffevent config, event filter und event notification – Vollzugriff |
Ermöglicht das Protokollieren von Ereignissen an benutzerdefinierten Zielen. Mit event log show können Sie Protokollereignisse nach Zeit oder Typ anzeigen lassen. |
| Job | ONTAP-Jobs auf Knoten- und Clusterebene verwalten | job show, job schedule, job private, job stop und job resume – Vollzugriff |
|
| LUN | LUNs und Initiatorgruppen erstellen und verwalten und fremde LUNs importieren | lun create, lun bind und igroup – Vollzugriff |
lun import ist zwar zulässig, es ist jedoch nicht möglich, externe Laufwerke mit einem System im ONTAP-Modus zu verbinden. |
| Netzwerk | Netzwerkport-, Schnittstellen-, Routen- und IPspace-Konfigurationen anzeigen, Ping und Traceroute zu externen IP-Adressen ausführen und Clientverbindungen nach Protokoll anzeigen | network ping, network traceroute, network port interface, network ipspace und network connections – Lesezugriff |
|
| Dienstqualität | QoS-Richtliniengruppen (QPGs) erstellen und verwalten und sie Volumes zuweisen. Der Gesamtdurchsatz und die IOPS des Pools legen die Obergrenze fest. | qos policy-group create, qos policy-group modify und qos policy-group delete: Vollzugriffqos policy-group show: Schreibgeschütztvolume create -qos-policy-group und volume modify -qos-policy-group: Volume an eine QPG anhängen, in eine andere QPG verschieben oder mit none trennen |
|
| Sicherheit | Audit-Konfiguration anzeigen, Anti-Ransomware-Funktion aktivieren und Zertifikate erstellen und installieren | security audit – schreibgeschütztsecurity anti-ransomware volume und security certificate – Vollzugriff |
Anti-Ransomware-Parameter können beim Erstellen des Volumes festgelegt werden. Sie können nur Server- und Clientzertifikate erstellen. |
| SnapLock | SnapLock-Uhr und -Protokolle verwalten und ereignisbasierte SnapLock-Aufbewahrung und Litigation Hold-Vorgänge steuern | snaplock compliance-clock und snaplock log – Vollzugriff |
Verwenden Sie den Befehl volume snaplock modify, um SnapLock auf einzelnen Volumes zu konfigurieren. Sie können die SnapLock-Befehle snaplock event-retention und snaplock legal-hold nur über die ONTAP REST API verwalten. |
| SnapMirror | SnapMirror-Beziehungen erstellen und verwalten | snapmirror create, snapmirror initialize, snapmirror break und snapmirror resync – Vollzugriff |
|
| Statistiken | Regelmäßige Systemstatistiken anzeigen oder Stichproben bestimmter Statistiken erstellen | statistics samples, statistics start, statistics stop und statistics show-periodic – Vollzugriffstatistics volume, statistics lun, statistics aggregate, statistics qtree und statistics SVM – Lesezugriff |
Für viele Befehle ist der erweiterte Modus erforderlich, um ihre Parameter anzugeben. |
| System | Systembefehle werden im Allgemeinen nicht unterstützt, aber AutoSupport und die Übertragung von Leistungsarchiven können aufgerufen werden | system node autosupport invoke und system node autosupport invoke-performance-archive – Vollzugriff |
AutoSupport-Dateien sind für den NetApp-Support verfügbar. |
| Volumen | Volumes erstellen und verwalten | volume create, volume delete, volume modify, volume clone, volume expand (FlexGroup), volume flexcache, volume flexgroup, qtree, quota, snaplock und snapshot – Vollzugriff |
Einige Volume-Funktionen wie die Berichterstellung/Erzwingung von logischem Speicherplatz und die Speicherplatzgarantie (keine) werden automatisch vom System verwaltet. Legen Sie die Volume-Tiering-Richtlinie so fest, dass das auf Poolebene festgelegte automatische Tiering verwendet wird. |
| Vserver | Verwalten Sie die SVM (vserver) für den Datei- (SMB, NFS), Block- (iSCSI, NVMe) und Objektzugriff (S3) auf Volumes. Verwalten Sie Richtlinien, die für Volumes verwendet werden, z. B. Exportrichtlinien für NFS. Aktivieren Sie SVM-Features wie Audit-Logging (Dateizugriff), Konsistenzgruppen, Richtlinien, Namensdienste (DNS, LDAP) und Antivirenprogramme (vscan). Peering von SVMs für SnapMirror und FlexCache. |
vserver cifs create (Beitritt zu einer Active Directory-Domain), vserver nfs create, vserver iscsi create und vserver nvme create – Vollzugriffvserver object-store-server – Vollzugriff |
Verwenden Sie den Befehl vserver modify, um die Standardsprache, den Sicherheitsstil sowie die Snapshot- und Kontingentrichtlinien für alle Volumes festzulegen.vserver create wird derzeit nicht unterstützt.Befehle zum Ändern des Passworts können nicht interaktiv ausgeführt werden und müssen mithilfe von Befehlsparametern oder der REST API angegeben werden. |
| Legacy-Befehle | timezone und version – Vollzugriff |
Pool im ONTAP-Modus löschen
Wenn Sie einen Pool im ONTAP-Modus löschen möchten, müssen Sie zuerst alle Volumes im Pool löschen.