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.

Abbildung 1. Szenario: Benutzeranmeldedaten angeben, um Informationen zu einer Warnung mit der ID 123 abzurufen
Zugriff auf geschützten Endpoint mit gültigen Anmeldedaten
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: 
https://au.www.mgmt.cloud.vmware.com/vrops-cloud/suite-api
Sie müssen das Cloud Services Console-Authentifizierungstoken mit jeder Anforderung als HTTP-Header im folgenden Format übergeben: 
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.
  • Bei einem Anforderungstext in XML muss die Kopfzeile Content-Type: application/xml enthalten.
  • Bei einem Anforderungstext in JSON muss die Kopfzeile Content-Type: application/json enthalten.
Akzeptieren Um das gewünschte Antwortformat anzugeben, können Sie die Anforderung mit der Kopfzeile Accept versehen.
  • Bei einer Antwort in XML muss die Kopfzeile Accept: application/xml enthalten.
  • Bei einer Antwort in JSON muss die Kopfzeile Accept: application/json enthalten.

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.