Kaspersky Security for Virtualization 6.0 Light Agent

Obtention de la liste de machines virtuelles du locataire

14 décembre 2023

ID 259249

Vous permet d'obtenir une liste de toutes les machines virtuelles enregistrées du locataire.

Méthode :

GET /api/2.0/virtualization/tenants/{identifiant du locataire}/vms

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 une liste de machines virtuelles et des informations sur chaque machine virtuelle du locataire sous la forme suivante :

<vm id="{identifiant dans la base}" biosId={identifiant BIOS ID} created="{date et heure}" updated="{date et heure}">

<name>{nom}</name>

<userData><![CDATA[{informations complémentaires}]]></userData>

</vm>

où :

  • {identifiant dans la base} : identifiant attribué à la machine virtuelle dans la base de données du Serveur d'intégration.
  • {identifiant BIOS ID} : identifiant de la machine virtuelle (BIOS ID) au format UUID.
  • created="{date et heure}" : date et heure de l'enregistrement de la machine virtuelle 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 sur la machine virtuelle dans la base de données du Serveur d'intégration au format AAAA-MM-JJThh:mm:ss.
  • {nom} : nom de la machine virtuelle.
  • {informations supplémentaires} : informations supplémentaires sur la machine virtuelle entrées dans la base de données du Serveur d'intégration.

Codes de retour :

  • 200 (OK) : demande aboutie. La réponse renvoie la liste de machines virtuelles du locataire.
  • 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.

Cet article vous a-t-il été utile ?
Que pouvons-nous améliorer ?
Merci de nous faire part de vos commentaires. Vous nous aidez à nous améliorer.
Merci de nous faire part de vos commentaires. Vous nous aidez à nous améliorer.