Führen Sie Ihren ersten ONTAP tools REST API-Aufruf durch
Ein API-Aufruf mit curl ermöglicht den Einstieg in die ONTAP tools for VMware vSphere 10 REST API.
Bevor Sie beginnen
Die erforderlichen Informationen und Parameter, die in den curl-Beispielen benötigt werden, sollten überprüft werden.
Sie benötigen Folgendes:
-
ONTAP tools for VMware vSphere 10 IP-Adresse oder FQDN sowie den Port
-
Anmeldeinformationen für den ONTAP tools Manager Admin (Benutzername und Passwort)
Die unten aufgeführten curl-Beispiele verwenden Variablen im Bash-Stil. Diese Variablen können in der Bash-Umgebung festgelegt oder vor der Ausführung der Befehle manuell aktualisiert werden. Wenn die Variablen festgelegt sind, ersetzt die Shell die Werte in jedem Befehl, bevor dieser ausgeführt wird. Die Variablen werden in der folgenden Tabelle beschrieben.
| Variable | Beschreibung |
|---|---|
$FQDN_IP_PORT |
Der vollqualifizierte Domainname oder die IP-Adresse des ONTAP tools Managers zusammen mit der Portnummer. |
$MYUSER |
Benutzername für das ONTAP tools Manager Konto. |
$MYPASSWORD |
Passwort, das mit dem Benutzernamen des ONTAP tools Manager verknüpft ist. |
$ACCESS_TOKEN |
Das vom ONTAP tools Manager ausgestellte Zugriffstoken. |
Die folgenden Befehle und Ausgaben an der Linux-Befehlszeile veranschaulichen, wie eine Variable gesetzt und angezeigt werden kann:
FQDN_IP_PORT=172.14.31.224:8443 echo $FQDN_IP 172.14.31.224:8443
Schritt 1: Zugriffstoken abrufen
Um die REST API nutzen zu können, benötigen Sie ein Zugriffstoken. Ein Beispiel für die Anforderung eines Zugriffstokens wird unten dargestellt. Dabei sind die entsprechenden Werte für Ihre Umgebung einzusetzen.
curl --request POST \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/auth/login” \
--header "Content-Type: application/json" \
--header "Accept: */*" \
-d "{"username": "$MYUSER", "password": "$MYPASSWORD"}"
Kopieren und speichern Sie das in der Antwort enthaltene Zugriffstoken.
Schritt 2: Den REST API-Aufruf ausführen
Nachdem Sie ein Zugriffstoken erhalten haben, kann curl verwendet werden, um einen REST-API-Aufruf durchzuführen. Das im ersten Schritt erworbene Zugriffstoken ist einzufügen.
curl --request GET \
--location "https://$FQDN_IP_PORT/virtualization/api/v1/vcenters" \
--header "Accept: */*" \
--header "x-auth: $ACCESS_TOKEN"
Die JSON-Antwort enthält eine Liste der VMware vCenter Instanzen, die für den ONTAP tools Manager konfiguriert sind.