Vous permet d'obtenir des informations sur le locataire à partir de la base de données du Serveur d'intégration.
Méthode :
GET /api/2.0/virtualization/tenants/{identifiant du locataire}
où :
{identifiant du locataire} : identifiant du locataire dans la base de données du Serveur d'intégration (paramètre obligatoire).
Si la demande aboutit, l'API REST renvoie les informations relatives au locataire sous la forme suivante :
<tenant id="{identifiant}" created="{date et heure}" updated="{date et heure}">
<name>{titre}</name>
<description>{description}</description>
<userData><![CDATA[{informations supplémentaires}]]></userData>
<!-- Les informations dans la section vKsc ne sont disponibles que pour le locataire de type « complet » -->
<vKsc id="{identifiant}">
<user>
<name>{administrateur}</name>
</user>
</vKsc>
<status>{statut}</status>
<type>{type de locataire}</type>
</tenant>
où :
tenant id="{identifiant}" : identifiant du locataire dans la base de données du Serveur d'intégration.created="{date et heure}" : date et heure de l'enregistrement du locataire dans la base de données du Serveur d'intégration au format AAAA-MM-JJThh:mm:ss.updated="{date et heure}" : date et heure de la mise à jour des informations relatives au locataire dans la base de données du Serveur d'intégration au format AAAA-MM-JJThh:mm:ss.{nom} : nom du locataire spécifié lors de la création du locataire.{description} : description du locataire.{informations supplémentaires} : informations supplémentaires sur le locataire saisies dans la base de données du Serveur d'intégration.vKsc id="{identifiant}" : identifiant attribué au Serveur d'administration virtuel du locataire dans Kaspersky Security Center.{administrateur} : nom de l'administrateur du Serveur d'administration virtuel du locataire.{statut} : statut actuel du locataire : « actif » (Active) ou « inactif » (Inactive).{ type de locataire } : type de locataire : « complet » (Complete) ou « simplifié » (Simple).Codes de retour :
200 (OK) : demande aboutie. Les informations relatives au locataire sont renvoyées en guise de réponse.403 (Forbidden) : l'accès à la ressource est refusé.404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound : le locataire avec l'identifiant spécifié est introuvable dans la base de données du Serveur d'intégration.