API

vCD API: OpenAPI und Legacy API

Die vCloud Director (vCD) API bietet zwei Hauptschnittstellen zur Verwaltung und Automatisierung von Cloud-Infrastrukturen: die OpenAPI und die Legacy API.

OpenAPI

Die OpenAPI ist die moderne RESTful-API von vCloud Director. Sie bietet eine umfassende Dokumentation und ist darauf ausgelegt, Entwickler bei der schnellen und effizienten Integration von vCD-Diensten zu unterstützen. OpenAPI nutzt JSON für Anfragen und Antworten, was die Verarbeitung und Integration in verschiedene Systeme vereinfacht.

Legacy API

Die Legacy API, auch bekannt als vCloud API, war die ursprüngliche API von vCloud Director. Sie verwendet XML als Datenformat und bietet ähnliche Funktionalitäten wie die OpenAPI, ist jedoch weniger effizient und benutzerfreundlich.

Beispiel für die Anmeldung mit PowerShell

Um sich über PowerShell bei der vCD API anzumelden, kann das folgende Beispielskript verwendet werden:

# vCD API-URL und Anmeldedaten
$apiUrl = "https://vcloud.example.com/api/sessions"
$username = "your-username"
$password = "your-password"
$organization = "your-organization"

# Basisauthentifizierungstoken erstellen
$encodedAuth = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("$username@$organization:$password"))

# HTTP-Header setzen
$headers = @{
    "Authorization" = "Basic $encodedAuth"
    "Accept" = "application/*+xml;version=33.0"
}

# API-Anfrage senden
$response = Invoke-RestMethod -Uri $apiUrl -Method Post -Headers $headers

# Ausgabe der Antwort
$response