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.