ONTAP im ONTAP-Modus verwalten

Auf dieser Seite wird beschrieben, wie Sie ONTAP im ONTAP-Modus verwalten.

Aus Sicherheits- und Protokollierungsgründen sind in NetApp Volumes keine direkten Verbindungen zur ONTAP-Management-LIF zulässig. Daher können Sie Tools wie SystemManager oder SSH nicht verwenden, um das ONTAP-System direkt zu verwalten. Stattdessen können Sie ONTAP-Vorgänge für Ihren Speicherpool im ONTAP-Modus mit den folgenden Methoden senden:

Die Verwaltungstools wie Terraform verwenden den Google API-Proxy, um ONTAP-Ressourcen zu verwalten.

Hinweis

Ihre Google Cloud CLI-Version muss mindestens 559.0.0 sein, um ONTAP-Vorgänge für Ihren ONTAP-Modus-Speicherpool 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

Der direkte SSH-Zugriff auf die ONTAP-Befehlszeile ist nicht verfügbar. Sie können jedoch ONTAP-Befehlszeilenbefehle mit der Google Cloud CLI an Ihren Speicherpool senden.

gcloud

ONTAP-Befehl ausführen:

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

  • ONTAP-COMMAND: Der ONTAP-Befehl, den Sie für den 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 bietet für jeden Speicherpool im FlexUnified ONTAP-Modus einen Google-API-Endpunkt, ü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.

Für Aufrufe des ONTAP-Proxys muss das folgende URL-Format verwendet werden:

  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/v1

  • Google-URN für den Speicherpool: /projects/PROJECT/locations/LOCATION/storagePools/POOL_NAME

    Ersetzen Sie die folgenden Informationen:

    • PROJECT: Ihre Projekt-ID oder Projektnummer.

    • LOCATION: Der Name der Zone für zonale Pools oder die Region für regionale Pools.

    • POOL_NAME: der Name des Pools.

  • ONTAP REST API path: /ontap/ONTAP_REST_URL. Weitere Informationen finden Sie in der ONTAP REST API-Referenz.

Alle Volumes eines Speicherpools auflisten

Das folgende Beispiel zeigt die vollständige URL zum Auflisten aller Volumes für den Speicherpool mypool in us-central1-a im Projekt myproject.

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 Speicherpool im Flex Unified ONTAP-Modus erstellen, der durch den URN /projects/myproject/locations/us-central1-a/storagePools/mypool identifiziert wird.

Informationen zum Erstellen eines Volumes finden Sie in der ONTAP REST API-Onlinedokumentation. Rufen Sie in der Dokumentation den Abschnitt Speicher auf und maximieren Sie dann Speichervolumes verwalten. In diesem Abschnitt finden Sie mehrere Beispiele.

So erstellen Sie ein Volume:

  1. Bestimmen Sie den ONTAP REST API-Endpunkt.

    Wenn Sie das einfache Beispiel in NetApp Volumes verwenden, ist der erforderliche ONTAP API-Endpunkt /api/storage/volumes. Mit diesem Endpunkt wird die URL https://netapp.googleapis.com/v1/projects/myproject/locations/us-central1-a/storagePools/mypool/ontap/api/storage/volumes erstellt.

  2. 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 Namen des Volumes zuzuweisen. Die Nutzlast für die Volume-Erstellung erfordert die Namen des Aggregats und der Storage Virtual Machine (SVM), die von NetApp Volumes während der Erstellung des ONTAP-Modus-Pools zugewiesen werden. Im ONTAP-Modus hat jeder Speicherpool eine SVM und ein Speicheraggregat. Diese Informationen können abgerufen werden, indem ONTAP nach allen SVMs abgefragt wird.

    So rufen Sie die SVM- und Aggregatnamen ab:

    1. ontap_fields zur Feldauswahl verwenden: Verwenden Sie in Pools im ONTAP-Modus von NetApp Volumes den Abfrageparameter ontap_fields= anstelle des Standard-ONTAP-Parameters fields=, um die angeforderten Felder anzugeben.

    2. Optional: Felder mitjq extrahieren: Im folgenden Beispiel wird das Open-Source-Tool jq verwendet, um name (SVM-Name) und aggregates aus der JSON-Antwort zu extrahieren. Das ist nützlich für die Verarbeitung in Shell-Scripts.

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

  3. Führen Sie den API-Aufruf zum Erstellen des Bandes aus.

    Erstellen Sie mit dem aggregierten Namen (aggr1) und dem SVM-Namen (gcnv-7cf6ee41c1a94f0-svm-01) die Nutzlast für die endgültige Volume-Erstellung und senden Sie den API-Aufruf. Die ONTAP API-Nutzlast muss für NetApp-Volumes in einem body: {}-Umschlag eingeschlossen werden.

    Im folgenden Beispiel wird ein Volume mit dem Namen myvolume und 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"
  }
}'

    Beim Erstellen von Volumes werden viele optionale Parameter unterstützt, 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 der erforderlichen und optionalen Parameter. Außerdem enthält sie detaillierte Beispiele für Nutzlasten und Antworttexte.

    Wenn Sie automatisches Tiering in der ONTAP REST API konfigurieren möchten, fügen Sie das JSON-Objekt tiering in den Anfragetext ein:

    • Wenn Sie die Tiering-Richtlinie des Volumes auf all festlegen möchten, verwenden Sie "tiering": {"policy": "all"}.

    • Optional: Verwenden Sie "tiering": {"policy": "auto", "min_cooling_days": 31}, um die Kühltage zu konfigurieren.

      Sie können im Feld min_cooling_days einen Cooling-Threshold zwischen 2 und 183 Tagen angeben. Der Standardgrenzwert für die Abkühlungsphase beträgt 31 Tage.

    Wenn Sie den Hot-Tier umgehen und Daten direkt in den Cloud-Tier auf Lese-/Schreibvolumen 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

  4. ONTAP-Job überwachen

    Die meisten ONTAP-API-Aufrufe, z. B. POST- oder PATCH-Vorgänge, mit denen Ressourcen erstellt oder aktualisiert werden, 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 Antwort auf eine Stellenanzeige:

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

    Wenn Sie den Status des Jobs prüfen möchten, fragen Sie die Jobressource mit der zurückgegebenen uuid ab:

    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 state den Wert success hat, wird das Volume erstellt.

    In diesem Beispiel-Workflow wird beschrieben, wie Sie ONTAP-Aktionen in der ONTAP REST API-Dokumentation nachschlagen. Außerdem wird gezeigt, wie Sie das erforderliche Nutzlastformat erstellen und es mit einer Google API an den Speicherpool senden. Schließlich wird gezeigt, wie ein ONTAP-Job überwacht wird, bis die Ressource erstellt ist. 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 und kann sowohl für NetApp Volumes- als auch für ONTAP-Ressourcen verwendet werden.

Anhand der Tabelle Übersicht über die Funktionsverwaltung können Sie ermitteln, welchen Anbieter Sie verwenden sollten.

  • Der Google-Provider 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-Provider, Version 2.6.0 oder höher.

Weitere Informationen zur Einrichtung und Beispiele finden Sie in der NetApp ONTAP-Anbieterdokumentation.

Zulässige ONTAP-Aktionen

Wenn Sie über die API oder den CLI-Proxy auf einen Pool im ONTAP-Modus zugreifen, haben Sie nicht die 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 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 bei NetApp Volumes beispielsweise die logische Kapazität abgerechnet wird, blockiert das System Parameter für die Konfiguration 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 und physische 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“ umstellen möchten, fügen Sie set advanced; oder set -privilege advanced; am Anfang des Befehls ein. 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 Änderungen der Berechtigungen sind nicht dauerhaft.

Da der Proxy keine interaktive Shell ist, können Sie jeweils nur einen Befehl ausführen. Das bedeutet, dass der Proxy keine interaktiven Befehle unterstützt, mit denen zusätzliche Informationen angefordert werden. 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 und FlexCache sowie Anzeige ausgewählter Informationen zum Cluster cluster peer – Vollzugriff

cluster show, identity show, date show, ha show, statistics show und time-service ntp server show – schreibgeschützt		 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.
Fehlerbehebung Unterstützung für die Paketverfolgung (tcpdump), LUN und Fehlerbehebung bei Sperren debug network tcpdump, debug san lun und debug lock persistence – vollständiger Zugriff Für alle zulässigen Debugging-Befehle ist die Berechtigungsstufe diag erforderlich. Dies sind gängige Debugging-Befehle.
Ereignis Filter erstellen, um ONTAP-Ereignisse an SMTP- oder Syslog-Ziele zu senden event catalog show und Ereignisprotokoll show – schreibgeschützt

event config, event filter und Ereignisbenachrichtigung – vollständiger Zugriff		 Ermöglicht das Erfassen von Ereignissen an benutzerdefinierten Zielen. Mit event log show können Sie Protokollereignisse nach Zeit oder Typ anzeigen.
Job ONTAP-Jobs auf Knoten- und Clusterebene verwalten job show, job schedule, job private, job stop und job resume – vollständiger Zugriff
LUN LUNs und Initiatorgruppen erstellen und verwalten sowie fremde LUNs importieren lun create, lun bind und igroup – Vollzugriff Der LUN-Import ist zwar zulässig, es ist jedoch nicht möglich, fremde Festplatten mit einem System im ONTAP-Modus zu verbinden.
Netzwerk Netzwerkport-, Schnittstellen-, Routen- und IP-Space-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 – schreibgeschützt
Dienstqualität QoS-Richtliniengruppen erstellen und verwalten und die Leistung für sie anzeigen Alle QoS-Befehle – schreibgeschützt Die Einstellungen für die Dienstqualität sind schreibgeschützt.
Sicherheit Audit-Konfiguration anzeigen, Anti-Ransomware-Funktion aktivieren sowie Zertifikate erstellen und installieren Sicherheitsaudit – schreibgeschützt

Sicherheitsvolumen für Anti-Ransomware und Sicherheitszertifikat – vollständiger Zugriff		 Beim Erstellen des Volumes können Anti-Ransomware-Parameter festgelegt werden. Sie können nur Server- und Clientzertifikate erstellen.
SnapLock SnapLock-Uhr und ‑Protokolle verwalten und ereignisbasierte Aufbewahrungs- und Litigation Hold-Vorgänge in SnapLock steuern snaplock compliance-clock und snaplock log – vollständiger Zugriff 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: Vollzugriff

statistics volume, statistics lun, statistics aggregate, statistics qtree und statistics SVM: schreibgeschützt		 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 des Leistungsarchivs können aufgerufen werden. system node autosupport invoke und system node autosupport invoke-performance-archive – vollständiger Zugriff 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, snapshot – Vollzugriff Einige Volumenfunktionen wie die Meldung/Durchsetzung von logischem Speicherplatz und die Speicherplatzgarantie (keine) werden automatisch vom System verwaltet. Legen Sie die Volume-Tiering-Richtlinie so fest, dass das automatische Tiering auf Poolebene verwendet wird.
Vserver Verwalten Sie den SVM (Vserver) für den Datei- (SMB, NFS), Block- (iSCSI, NVMe) und Objektzugriff (S3) auf Volumes.

Verwalten Sie Richtlinien für Volumes, z. B. Exportrichtlinien für NFS.

Aktivieren Sie SVM-Funktionen wie Audit-Logging (Dateizugriff), Konsistenzgruppen, Richtlinien, Namensdienste (DNS, LDAP) und Antivirus (vscan).

Peeren Sie SVMs für SnapMirror und FlexCache.		 vserver cifs create (join to an Active Directory domain), vserver nfs create, vserver iscsi create, and vserver nvme create - full access

vserver object-store-server - full access		 Verwenden Sie den Befehl vserver modify, um die Standardsprache, den Sicherheitsstil sowie die Snapshot- und Kontingentrichtlinien für alle Volumes festzulegen.

Der Befehl vserver create wird derzeit nicht unterstützt.
Befehle zum Ändern des Passworts können nicht interaktiv ausgeführt werden. Sie müssen über Befehlsparameter oder über die REST API angegeben werden.
Alte Befehle timezone und version – vollständiger Zugriff

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.