Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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-Verwaltungs-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 mit den folgenden Methoden an Ihren Speicherpool im ONTAP-Modus senden:

Google Cloud CLI ONTAP CLI-Proxy
Eine Google-Proxy-API für ONTAP-REST-API-Aufrufe

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, damit Sie ONTAP-Vorgänge für Ihren ONTAP-Modus-Speicherpool verwalten können. 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 CLI ist nicht verfügbar. Sie können jedoch ONTAP CLI-Befehle 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 Speicherpools im Flex Unified ONTAP-Modus.
ONTAP-COMMAND: Der ONTAP-Befehl, den Sie für den Cluster oder Speicherpool ausführen möchten.
PROJECT: Ihre Projekt-ID.
LOCATION: Der Speicherort Ihres Speicherpools.

Google-Proxy-API für ONTAP REST API-Aufrufe verwenden

NetApp Volumes bietet für jeden Speicherpool im Flex Unified 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 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-Pfad: /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

   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-Speicherpool im ONTAP-Modus mit der URN /projects/myproject/locations/us-central1-a/storagePools/mypool erstellen.

Informationen zum Erstellen eines Volumes finden Sie in der ONTAP REST API-Onlinedokumentation. Rufen Sie in der Dokumentation den Abschnitt Storage auf und maximieren Sie Manage storage volumes (Speichervolumes verwalten). Dieser Abschnitt enthält mehrere Beispiele.

So erstellen Sie ein Volume:

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.
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. Für die Nutzlast zum Erstellen von Volumes sind die Namen des Aggregats und der Storage Virtual Machine (SVM) erforderlich, 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 für die Feldauswahl verwenden: In NetApp Volumes ONTAP-Mode-Pools verwenden Sie den Abfrageparameter ontap_fields= anstelle des Standard-ONTAP-Parameters fields=, um die angeforderten Felder anzugeben.
2. Optional: jq verwenden, 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. Das 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 zum Erstellen des Volumes aus.

Erstellen Sie mit dem Aggregatnamen (aggr1) und dem SVM-Namen (gcnv-7cf6ee41c1a94f0-svm-01) die Nutzlast für die endgültige Volume-Erstellung und senden Sie den API-Aufruf. Beachten Sie, dass die ONTAP API-Nutzlast für NetApp Volumes in einem body: {}-Umschlag eingeschlossen werden 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"
  }
}'
```
Beim Erstellen von Volumes werden viele optionale Parameter unterstützt, z. B. size. Die Nutzlast gibt beispielsweise eine Größe von 2 GB an. 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.

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

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 success ist, 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 die Verwaltung von NetApp Volumes- als auch von ONTAP-Ressourcen verwendet werden.

Anhand der Tabelle Übersicht zur 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-Anbieter, Version 2.6.0 oder höher.

Weitere Informationen zur Einrichtung und zu Beispielen 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 werden API-Anfrage- und Antwortnutzlasten vom System gefiltert. Da bei NetApp Volumes beispielsweise die logische Kapazität abgerechnet wird, werden Parameter zum Konfigurieren der physischen Kapazität vom System blockiert. Wenn Sie einen nicht zulässigen Parameter senden, gibt die API einen Fehler zurück.

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 sind gesperrt, 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 mit ONTAP-Administratorberechtigungen 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 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, 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, FlexCache und 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 `cluster peer create`-Befehl nicht. Verwenden Sie stattdessen die REST API. Sie können auch andere `cluster peer`-Befehle wie `show` verwenden.
Fehlerbehebung	Unterstützung von Paket-Tracing (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 häufig verwendete Debugging-Befehle.
Ereignis	Filter erstellen, um ONTAP-Ereignisse an SMTP- oder Syslog-Ziele zu senden	event catalog show und event log 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	Netzwerk-Ping, Netzwerk-Traceroute, Netzwerk-Port-Schnittstelle, Netzwerk-IP-Bereich und Netzwerkverbindungen – schreibgeschützt
Dienstqualität	QoS-Richtliniengruppen erstellen und verwalten und die Leistung für sie anzeigen lassen	Alle QoS-Befehle – schreibgeschützt	Die Einstellungen für die Dienstqualität können nur angesehen werden.
Sicherheit	Audit-Konfiguration anzeigen, Anti-Ransomware-Funktion aktivieren und Zertifikate erstellen und installieren	Sicherheitsaudit – schreibgeschützt Sicherheitsvolumen für Anti-Ransomware und Sicherheitszertifikat – vollständiger Zugriff	Beim Erstellen des Volumes können Parameter zur Ransomware-Abwehr festgelegt werden. Sie können nur Server- und Clientzertifikate erstellen.
SnapLock	SnapLock-Uhr und ‑Protokolle verwalten und ereignisbasierte Aufbewahrung und Litigation Hold-Vorgänge für SnapLock steuern	snaplock compliance-clock und snaplock log – vollständiger Zugriff	Verwenden Sie den Befehl volume snaplock modify, um SnapLock für einzelne 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 die Parameter anzugeben.
System	Systembefehle werden in der Regel 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 Volume-Funktionen 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. vserver create wird derzeit nicht unterstützt. Befehle zum Ändern des Passworts können nicht interaktiv ausgeführt werden und 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.