Obtention d'informations relatives au locataire

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.