Mandanteninformationen abrufen

Ermöglicht das Abrufen von Informationen zum Mandanten aus der Datenbank des Integrationsservers.

Methode:

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

wobei:

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

Bei erfolgreichem Abruf der Anforderung gibt REST API Informationen über den Mandanten in folgender Form zurück:

<tenant id="{ID}" created="{Datum und Uhrzeit}" updated="{Datum und Uhrzeit}">

<name>{Bezeichnung}</name>

<description>{Beschreibung}</description>

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

<!-- Die Informationen im Abschnitt vKsc sind nur für Mandanten vom Typ "vollständig" verfügbar -->

<vKsc id="{ID}">

<user>

<name>{Administrator}</name>

</user>

</vKsc>

<status>{Status}</status>

<type>{Mandantentyp}</type>

</tenant>

wobei:

• tenant id="{ID}" – Mandanten-ID in der Datenbank des Integrationsservers.
• created="{Datum und Uhrzeit}" – Datum und Uhrzeit der Registrierung des Mandanten in der Datenbank des Integrationsservers im Format YYYY-MM-DDThh:mm:ss.
• updated="{Datum und Uhrzeit}" – Datum und Uhrzeit der Aktualisierung der Mandanteninformationen in der Datenbank im Format YYYY-MM-DDThh:mm:ss.
• {Bezeichnung} – Bezeichnung des Mandanten, die beim Erstellen des Mandanten angegeben wurde.
• {Beschreibung} – Beschreibung des Mandanten.
• {zusätzliche Informationen} – zusätzliche Informationen zum Mandanten, die in die Datenbank des Integrationsservers eingegeben wurden.
• vKsc id ="{ID}" – ID, die in Kaspersky Security Center dem virtuellen Administrationsserver des Mandanten zugewiesen ist.
• {Administrator} – Name des Administrators des virtuellen Administrationsservers des Mandanten.
• {Status} – aktueller Status des Mandanten: "aktiv" (Active) oder "inaktiv" (Inactive).
• {Mandantentyp} – Mandantentyp: "vollständig" (Complete) oder "einfach" (Simple).

Rückgabecodes:

• 200 (OK) – Anforderung erfolgreich abgeschlossen. In der Antwort kehren die Mandanteninformationen 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.