Liste der virtuellen Maschinen des Mandanten abrufen

Ermöglicht das Abrufen einer Liste aller registrierten virtuellen Maschinen des Mandanten.

Methode:

GET /api/2.0/virtualization/tenants/{Mandanten-ID}/vms

wobei:

{Mandanten-ID} – Mandanten-ID in der Datenbank des Integrationsservers (Pflichtparameter).

Wenn die Anforderung erfolgreich abgeschlossen wurde, gibt die REST API eine Liste der virtuellen Maschinen und Informationen zu jeder virtuellen Mandantenmaschine in folgender Form zurück:

<vm id="{ID in Datenbank}" biosId={BIOS ID} created="{Datum und Uhrzeit}" updated="{Datum und Uhrzeit}">

<name>{Name}</name>

<userData><![CDATA[{zusätzliche Informationen}]]></userData>

</vm>

wobei:

• {ID in Datenbank} – ID, die der virtuellen Maschine in der Datenbank des Integrationsservers zugewiesen ist
• {BIOS ID} – ID der virtuellen Maschine (BIOS ID) im UUID-Format
• created="{Datum und Uhrzeit}" – Datum und Uhrzeit der Registrierung der virtuellen Maschine in der Datenbank des Integrationsservers im Format YYYY-MM-DDThh:mm:ss
• updated="{Datum und Uhrzeit}" – Datum und Uhrzeit der Aktualisierung der Informationen zur virtuellen Maschine in der Datenbank im Format YYYY-MM-DDThh:mm:ss
• {Name} – Name der virtuellen Maschine
• {zusätzliche Informationen} – Zusätzliche Informationen zur virtuellen Maschine, die in die Datenbank des Integrationsservers eingegeben wurden

Rückgabecodes:

• 200 (OK) – Anforderung erfolgreich abgeschlossen. Die Antwort gibt eine Liste der virtuellen Maschinen des Mandanten zurück.
• 403 (Forbidden) – Der Zugriff auf die Ressource wird verweigert.
• 404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound – Ein Mandant mit der angegebenen ID wurde in der Datenbank des Integrationsservers nicht gefunden.

Nach oben