Clients stellen HTTP-Anforderungen an Objektreferenzen, um Objektdarstellungen abzurufen.
Sicherheit
Der HTTP-Link zwischen einem API-Client und dem API-Server wird per SSL hergestellt. API-Clients konfigurieren die Token-Authentifizierung für die Kommunikation mit dem Server.

Sie können die
vRealize Operations Cloud-APIs aufrufen, nachdem Sie das
Cloud Services Console-Authentifizierungstoken generiert haben. Verwenden Sie folgenden Endpoint:
https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api
Hinweis: Wenn sich Ihre Organisation außerhalb der USA befindet, verwenden Sie die Länderabkürzung für Ihren API-Endpoint. Die Verwendung des falschen Endpoints führt zu einem 404-Fehler. Wenn sich Ihre Organisation z. B. in Australien befindet, lautet Ihre Länderabkürzung AU, und Sie finden Ihre API-Dokumentation unter:
Sie müssen das
Cloud Services Console-Authentifizierungstoken mit jeder Anforderung als HTTP-Header im folgenden Format übergeben:
https://au.www.mgmt.cloud.vmware.com/vrops-cloud/suite-api
Authorization: CSPToken {CSP Auth Token}Beispiel:
curl -k https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/resources -H "Content-Type: application/json" -H "Accept: application/json" -H "Authorization: CSPToken abc12345...
Anforderungskopfzeilen
Die folgenden HTTP-Kopfzeilen sind in der Regel in API-Anforderungen enthalten:
Accept-Language | Mit der Anforderungskopfzeile Accept-Language können Sie angeben, in welcher Sprache die Antwort sein soll. Die Zeichenfolgen der Nachrichten in ErrorType-Antworten sind lokalisiert. Mit der folgenden Kopfzeile können Sie eine Antwort anfordern, deren Nachrichten in französischer Sprache lokalisierte Zeichenfolgen enthalten: Accept-Language: fr-FR |
Autorisierung | Alle Anforderungen zur Erstellung einer API-Sitzung müssen eine Authorization -Kopfzeile des von dem Identitätsanbieter, den Ihre Organisation verwendet, vorgegebenen Formulars enthalten. |
Content-Type | Anforderungen mit einem Text müssen eine entsprechende Content-Type -Kopfzeile in HTTP enthalten.
|
Akzeptieren | Um das gewünschte Antwortformat anzugeben, können Sie die Anforderung mit der Kopfzeile Accept versehen.
|
Anforderungstext in XML
Bei einem in XML geschriebenen Anforderungstext validiert vRealize Operations Cloud mit einem XML-Parser, ob die die Reihenfolge und Anzahl der Elemente in einem Anforderungstext mit dem Schema übereinstimmt. Anforderungstexte werden als ungültig zurückgewiesen, wenn sie folgende Kriterien nicht erfüllen:
- Für alle durch Elemente in der Anforderung dargestellten Namensräume müssen XML-Namensraumattribute angegeben werden.
- Wenn in der Anforderung mehrere Namensräume dargestellt werden, müssen die XML-Namensraumattribute als Kennung ein Präfix enthalten, das für alle Elemente dieses Namensraums verwendet wird.
- Alle erforderlichen Elemente müssen im Anforderungstext erscheinen. Für alle Elemente, die im Anforderungstext erscheinen, ist die im Schema vorgesehene Reihenfolge einzuhalten. Für den Inhalt der Elemente gelten die im Schema angegebenen Typenbeschränkungen.