Skip to main content
Active IQ Unified Manager
Eine neuere Version dieses Produkts ist erhältlich.
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Fehlerbehebung bei ONTAP Volumes mithilfe der Active IQ Unified Manager Gateway APIs

Änderungen vorschlagen
PDFs

Die Gateway-APIs fungieren als Schnittstelle, um ONTAP-APIs aufzurufen, Informationen über Ihre ONTAP Storage-Objekte abzufragen und Abhilfemaßnahmen zu ergreifen, um die gemeldeten Probleme zu beheben.

Dieser Workflow behandelt einen beispielhaften Anwendungsfall, in dem ein Ereignis ausgelöst wird, wenn ein ONTAP Volume seine Kapazität fast erreicht. Der Workflow zeigt außerdem, wie dieses Problem durch den Aufruf einer Kombination aus Active IQ Unified Manager und ONTAP REST-APIs behoben werden kann.

Hinweis

Vor dem Ausführen der Workflow-Schritte müssen die folgenden Voraussetzungen erfüllt sein:

  • Sie kennen die Gateway-APIs und deren Verwendung. Informationen dazu finden Sie unter "Zugriff auf ONTAP APIs über Proxy-Zugriff".

  • Sie sind mit der Verwendung von ONTAP REST APIs vertraut. Informationen zur Verwendung von ONTAP REST APIs sind unter "ONTAP Automatisierungsdokumentation" verfügbar.

  • Sie sind ein Anwendungsadministrator.

  • Auf dem Cluster, auf dem Sie die REST API Vorgänge ausführen möchten, muss ONTAP 9.5 oder höher ausgeführt werden, und der Cluster muss über HTTPS zu Unified Manager hinzugefügt werden.

Das folgende Diagramm veranschaulicht jeden Schritt im Workflow zur Fehlerbehebung bei Problemen mit der Kapazitätsauslastung von ONTAP Volumes.

Ein Diagramm

Der Workflow umfasst die Aufrufpunkte sowohl von Unified Manager als auch der ONTAP REST APIs.

  1. Der Volumennamen aus dem Ereignis, das die Kapazitätsauslastung des Volumes meldet, ist zu beachten.

  2. Für die Abfrage des Volume mit dem Volumennamen als Wert im Parameter „name“ steht die folgende Unified Manager API zur Verfügung.

    Kategorie HTTP-Verb Pfad

    Datacenter

    GET

    /datacenter/storage/volumes

  3. Aus der Ausgabe lassen sich die Cluster-UUID und die Volume-UUID entnehmen.

  4. In der Web-Benutzeroberfläche von Unified Manager kann unter Allgemein > Funktionseinstellungen > API Gateway überprüft werden, ob die API Gateway Funktion aktiviert ist. Solange sie nicht aktiviert ist, stehen die APIs der Gateway Kategorie nicht zum Aufrufen zur Verfügung. Falls die Funktion deaktiviert ist, sollte sie aktiviert werden.

  5. Die Cluster-UUID ermöglicht das Ausführen der ONTAP API /storage/volumes/{uuid} über API gateway. Die Abfrage gibt die Volume-Details zurück, wenn die Volume-UUID als API-Parameter übergeben wird.

    Für die Ausführung der ONTAP APIs über API gateway werden die Unified Manager Anmeldeinformationen intern zur Authentifizierung übergeben, sodass kein zusätzlicher Authentifizierungsschritt für den Zugriff auf einzelne Cluster erforderlich ist.

    Kategorie HTTP-Verb Pfad

    Unified Manager: Gateway

    ONTAP: Storage

    GET

    Gateway-API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}
    Hinweis

    In /gateways/{uuid}/{path} muss der Wert für {uuid} durch die Cluster-UUID ersetzt werden, auf der die REST-Operation ausgeführt werden soll. {path} muss durch die ONTAP REST-URL /storage/volumes/{uuid} ersetzt werden.

    Die angehängte URL lautet: /gateways/{cluster_uuid}/storage/volumes/{volume_uuid}

    Beim Ausführen der GET-Operation wird folgende URL generiert: GEThttps://<hostname\>/api/gateways/<cluster_UUID\>/storage/volumes/{volume_uuid}

    Beispiel für einen cURL-Befehl

    curl -X GET "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7"
-H "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>"

  6. Anhand der Ausgabe lassen sich Größe, Nutzung und die zu ergreifende Abhilfemaßnahme bestimmen. In diesem Workflow besteht die ergriffene Abhilfemaßnahme in der Anpassung der Größe des Volume.

  7. Für die Größenanpassung des Volumes sind die Cluster UUID und die Ausführung der folgenden ONTAP API über das API Gateway erforderlich. Informationen zu den Eingabeparametern für das Gateway und die ONTAP APIs finden Sie in Schritt 5.

    Kategorie HTTP-Verb Pfad

    Unified Manager: Gateway

    ONTAP: Storage

    PATCH

    Gateway-API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}
    Hinweis

    Neben der Cluster UUID und der Volume UUID muss für die Größenänderung des Volumes ein Wert für den Parameter size eingegeben werden. Wichtig ist, dass der Wert in Byte angegeben wird. Wenn beispielsweise die Größe eines Volumes von 100 GB auf 120 GB erhöht werden soll, wird der Wert für den Parameter size am Ende der Abfrage angegeben: -d {\"size\": 128849018880}"

    Beispiel für einen cURL-Befehl

    curl -X PATCH "https://<hostname>/api/gateways/1cd8a442-86d1-11e0-ae1c-9876567890123/storage/volumes/028baa66-41bd-11e9-81d5-00a0986138f7" -H
    "accept: application/hal+json" -H "Authorization: Basic <Base64EncodedCredentials>" -d
    {\"size\": 128849018880}"

    Die JSON-Ausgabe gibt eine Job-UUID zurück.

  8. Anhand der Job-UUID lässt sich überprüfen, ob der Job erfolgreich ausgeführt wurde. Die folgende ONTAP API kann über das API-Gateway mit der Cluster-UUID und der Job-UUID ausgeführt werden. Informationen zu den Eingabeparametern für das Gateway und ONTAP-APIs finden Sie in Schritt 5.

    Kategorie HTTP-Verb Pfad

    Unified Manager: Gateway

    ONTAP: Cluster

    GET

    Gateway-API: /gateways/{uuid}/{path}

    ONTAP-API: /cluster/jobs/{uuid}

    Die zurückgegebenen HTTP-Codes entsprechen den HTTP-Statuscodes der ONTAP REST API.

  9. Die folgende ONTAP API dient zum Abfragen der Details des vergrößerten Volumes. Informationen zu den Eingabeparametern für das gateway und die ONTAP APIs sind in Schritt 5 enthalten.

    Kategorie HTTP-Verb Pfad

    Unified Manager: Gateway

    ONTAP: Storage

    GET

    Gateway-API: /gateways/{uuid}/{path}

    ONTAP API: /storage/volumes/{uuid}

    Die Ausgabe zeigt eine erhöhte Volumengröße von 120 GB an.