Ermöglicht das Abrufen von Informationen zum Mandanten aus der Datenbank des Integrationsservers.
Methode:
GET /api/2.0/virtualization/tenants/{Mandanten-ID}
wobei gilt:
{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.