Fehlerbehebung bei ONTAP Volumes mithilfe von Gateway-APIs
-
PDF dieser Dokumentationssite
-
Durchführung von Konfigurations- und Administrationsaufgaben
-
Online-Hilfe
-
Überwachung und Management der Cluster-Performance
-
Überwachen und managen Sie den Cluster-Zustand
-
![](https://docs.netapp.com/common/images/pdf-zip.png)
Sammlung separater PDF-Dokumente
Creating your file...
Die Gateway-APIs dienen als Gateway zum Aufrufen von ONTAP APIs, mit denen Informationen über Ihre ONTAP Storage-Objekte abgefragt und Korrekturmaßnahmen ergriffen werden, um die gemeldeten Probleme anzugehen.
Dieser Workflow greift auf einen Beispielfall zurück, in dem ein Ereignis angehoben wird, wenn ein ONTAP-Volume fast seine Kapazität erreicht. Im Workflow wird außerdem gezeigt, wie Sie das Problem beheben können, indem Sie eine Kombination aus Active IQ Unified Manager und ONTAP REST APIs aufrufen.
|
Bevor Sie die Workflow-Schritte ausführen, stellen Sie Folgendes sicher:
|
Das folgende Diagramm zeigt jeden Schritt im Workflow zur Fehlerbehebung bei der Verwendung von ONTAP Volume-Kapazität.
![ONTAP-Workflow des api-Gateways](../media/api-gateway-ontap-workflow.gif)
Der Workflow umfasst die Anrufinungspunkte sowohl von Unified Manager als auch von ONTAP REST-APIs.
-
Notieren Sie den Volume-Namen aus dem Ereignis, um die Kapazitätsauslastung des Volume zu benachrichtigen.
-
Durch Verwendung des Volume-Namens als Wert im
name
Parameter, Abfrage des Volumes durch Ausführung der folgenden Unified Manager API.Kategorie HTTP-Verb Pfad Rechenzentrum
GET
/datacenter/storage/volumes
-
Abrufen der Cluster-UUID und Volume-UUID von der Ausgabe.
-
Navigieren Sie in der Web-UI von Unified Manager zu Allgemein > Funktionseinstellungen > API Gateway, um zu überprüfen, ob die API-Gateway-Funktion aktiviert ist. Sofern sie nicht aktiviert ist, werden die APIs unter dem angezeigt
gateway
Die Kategorie kann nicht aufgerufen werden. Aktivieren Sie die Funktion, wenn sie deaktiviert ist. -
Verwenden Sie die Cluster-UUID zum Ausführen der ONTAP-API
/storage/volumes/{uuid}
Über das API-Gateway. Die Abfrage gibt die Volume-Details zurück, wenn die Volume-UUID als API-Parameter übergeben wird.Zur Ausführung der ONTAP-APIs über das API-Gateway werden die Anmeldeinformationen für den Unified Manager zur internen Authentifizierung übergeben. Sie müssen keinen zusätzlichen Authentifizierungsschritt für den individuellen Cluster-Zugriff ausführen.
Kategorie HTTP-Verb Pfad Unified Manager: gateway ONTAP: Storage
GET
Gateway-API:
/gateways/{uuid}/{path}
ONTAP-API:
/storage/volumes/{uuid}
In
/gateways/{uuid}/{path}
, Der Wert für{uuid}
Muss durch die Cluster-UUID ersetzt werden, für die der REST-Vorgang ausgeführt werden soll.{path}
Muss durch die ONTAP REST-URL ersetzt werden/storage/volumes/{uuid}
.Die angehängte URL lautet:
/gateways/{cluster_uuid}/storage/volumes/{volume_uuid}
Bei Ausführung der
GET
Die generierte URL lautet:GEThttps://<hostname>/api/gateways/<cluster_UUID>/storage/volumes/{volume_uuid}
Befehl zum Curl-Beispiel
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>"
-
Bestimmen Sie von der Ausgabe die zu ergriffende Größe, Nutzung und Abhilfemaßnahme. In diesem Workflow ist die Abhilfemaßnahme die Größe des Volumens.
-
Verwenden Sie die Cluster-UUID, und führen Sie die folgende ONTAP-API über das API-Gateway aus, um die Größe des Volumes zu ändern. Informationen zu den Eingabeparametern für das Gateway und 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}
Zusammen mit der Cluster-UUID und der Volume-UUID müssen Sie einen Wert für den eingeben
size
Parameter für die Größe des Volumens. Stellen Sie sicher, dass Sie den Wert in Byte eingeben. Wenn Sie beispielsweise die Größe eines Volumes von 100 GB auf 120 GB erhöhen möchten, geben Sie den Wert für den Parameter einsize
Am Ende der Abfrage:-d {\"size\": 128849018880}"
Befehl zum Curl-Beispiel
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.
-
Überprüfen Sie, ob der Job erfolgreich ausgeführt wurde, indem Sie die Job-UUID verwenden. Verwenden Sie die Cluster-UUID und Job-UUID, um die folgende ONTAP-API über das API-Gateway auszuführen. 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.
-
Führen Sie die folgende ONTAP API aus, um die Details des Volumes mit der Größe zu abfragen. Informationen zu den Eingabeparametern für das Gateway und ONTAP APIs finden Sie in Schritt 5.
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 Lautstärke von 120 GB an.