ONTAP im ONTAP-Modus verwalten

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

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

    Ersetzen 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:

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

  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 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:

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

    2. Optional: Verwenden Siejq , um Felder zu extrahieren: Im folgenden Beispiel wird das Open-Source-Tool jq verwendet, um name (SVM-Name) und aggregates aus 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"
      }
      
  3. 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 einem body: {}-Umschlag enthalten sein muss.

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

    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 tiering in den Anfragetext ein:

    • Verwenden Sie "tiering": {"policy": "all"}, um die Tiering-Richtlinie des Volumes auf all festzulegen.

    • Optional: Verwenden Sie "tiering": {"policy": "auto", "min_cooling_days": 31}, um die Cooling-Tage zu konfigurieren.

      Sie können im Feld min_cooling_days einen 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
  4. Überwachen Sie den ONTAP-Job.

    Die meisten ONTAP API-Aufrufe, z. B. POST- oder PATCH-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 uuid ab, 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 state den Wert success hat, 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 – Vollzugriff

cluster 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 – Lesezugriff

event 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: Vollzugriff

qos policy-group show: Schreibgeschützt

volume 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
  • qos policy-group create erfordert -vserver.
  • Wenn Sie -is-shared weglassen, wird die QPG freigegeben.
  • -vserver ist für qos policy-group modify oder qos policy-group delete nicht erforderlich.
  • qos policy-group delete funktioniert nur, wenn keine Volumes angehängt sind. Trennen Sie sie zuerst mit volume modify -qos-policy-group none.
  • Die SVM-Richtlinie SVM-qos-policy spiegelt den Gesamtdurchsatz und die IOPS des Pools wider. Wenn Sie diese Summen ändern möchten, verwenden Sie gcloud netapp storage-pools update --total-throughput oder --total-iops, nicht die ONTAP-Befehlszeile.
Sicherheit Audit-Konfiguration anzeigen, Anti-Ransomware-Funktion aktivieren und Zertifikate erstellen und installieren security audit – schreibgeschützt

security 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 – Vollzugriff

statistics 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 – Vollzugriff

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