Erfahren Sie mehr über die ONTAP tools REST API
ONTAP tools für VMware vSphere 10 ist eine Sammlung von Tools für das Lebenszyklusmanagement virtueller Maschinen. Enthalten ist eine leistungsstarke REST-API, die als Teil von Automatisierungsprozessen genutzt werden kann.
Grundlagen der REST-Webdienste
Representational State Transfer (REST) ist ein Stil zur Erstellung verteilter Webanwendungen, einschließlich des Designs von Web-Service-APIs. Es definiert eine Reihe von Technologien zur Bereitstellung serverbasierter Ressourcen und zur Verwaltung ihrer Zustände.
Ressourcen sind die grundlegenden Komponenten einer REST-Webservices-Anwendung. Beim Entwurf einer REST-API gibt es zwei wichtige erste Aufgaben:
-
System- oder serverbasierte Ressourcen identifizieren
-
Definieren der Ressourcenzustände und der zugehörigen Zustandsübergangsoperationen
Clientanwendungen können die Ressourcenzustände über klar definierte Nachrichtenflüsse anzeigen und ändern.
HTTP (Hypertext Transfer Protocol) ist das Protokoll, das von Webdienst-Client und -Server zum Austausch von Nachrichten über die Ressourcen verwendet wird. Es folgt dem CRUD-Modell basierend auf den generischen Operationen Erstellen, Lesen, Aktualisieren und Löschen. Das HTTP-Protokoll umfasst Anfrage- und Antwortheader sowie Antwortstatuscodes.
Obwohl verschiedene Nachrichtenformate zur Verfügung stehen, ist die JavaScript Object Notation (JSON) die gängigste Option. JSON ist ein Industriestandard zur Darstellung einfacher Datenstrukturen in Klartext und wird verwendet, um Zustandsinformationen zu übertragen, die die Ressourcen und gewünschten Aktionen beschreiben.
Sicherheit ist ein wichtiger Aspekt einer REST API. Zusätzlich zu dem Transport Layer Security (TLS) Protokoll, das den HTTP-Datenverkehr im Netzwerk schützt, verwenden die ONTAP tools for VMware vSphere 10 REST API außerdem Zugriffstoken zur Authentifizierung. Für nachfolgende API-Aufrufe ist ein Zugriffstoken erforderlich.
Die ONTAP tools for VMware vSphere 10 REST API führt die meisten Anfragen synchron aus und gibt einen Statuscode zurück, wenn der Vorgang abgeschlossen ist. Es wird außerdem asynchrone Verarbeitung für Aufgaben unterstützt, die mehr Zeit zur Ausführung benötigen.
ONTAP tools Manager Umgebung
Es gibt mehrere Aspekte der ONTAP tools Manager Umgebung, die berücksichtigt werden sollten.
ONTAP tools for VMware vSphere 10 wird mithilfe der vSphere Remote Plug-in-Architektur bereitgestellt. Die Software, einschließlich Unterstützung für die REST API, läuft in einer separaten virtuellen Maschine.
ONTAP tools for VMware vSphere 10 stellt eine einzelne IP-Adresse bereit, die als Gateway zu den Funktionen der virtuellen Maschine dient. Die Adresse ist während der Erstkonfiguration anzugeben und wird einer internen Load-Balancer-Komponente zugewiesen. Die Adresse wird sowohl von der ONTAP tools Manager-Benutzeroberfläche als auch für den direkten Zugriff auf die Swagger-Dokumentationsseite und die REST API verwendet.
Zusätzlich zur ONTAP tools for VMware vSphere 10 REST API verfügt der ONTAP Cluster über eine eigene REST API. ONTAP tools Manager verwendet die ONTAP REST API als Client, um speicherbezogene Aufgaben auszuführen. Es ist wichtig zu beachten, dass diese beiden APIs getrennt und unterschiedlich sind. Weitere Informationen finden sich unter "ONTAP Automatisierung".