Vous permet d'obtenir des informations sur la tâche par son identifiant.
Méthode :
GET /api/2.0/virtualization/tasks/{identifiant}
où :
{identifiant} : identifiant de la tâche (paramètre requis).
Si la demande aboutit, l'API REST renvoie des informations sur la tâche sous la forme suivante :
<task id="{identifiant}" created="{date et heure}" stateChanged="{date et heure}" changed="{date et heure}">
<state>{état}</state>
<type>{type}</type>
<stage>{étape}</stage>
<progress>{pourcentage de progression}</progress>
<result>{résultat}</result>
<!-- Si la tâche a échoué, un message d'erreur s'affiche à la place du résultat.-->
<error>{message d'erreur}</error>
</task>
où :
{identifiant} : identifiant de la tâche.created="{date et heure}" : heure de création de la tâche au format AAAA-MM-JJThh:mm:ss.stateChanged="{date et heure}" : heure de modification de l'état au format AAAA-MM-JJThh:mm:ss.changed="{date et heure}" : heure de modification de la tâche au format AAAA-MM-JJThh:mm:ss.{état} : état de la tâche.{type} : type de tâche. Par exemple :CreateTenant : tâche utilisée dans la procédure de création du client.ChangeTenantActivation : tâche utilisée dans les procédures d'activation et de désactivation du client.DeleteTenant : tâche utilisée dans la procédure de suppression du client.CreateTenantReport : une tâche utilisée dans la procédure de génération d'un rapport de protection des clients.{nom} : nom de la tâche.{étape} : étape d'exécution de la tâche.{pourcentage de progression} : progression de la tâche en pourcentage.{résultat} : résultat d'exécution de la tâche, par exemple, informations sur le client créé ou l'identifiant du rapport.{message d'erreur} : si une erreur se produit pendant l'exécution de la tâche, un message d'erreur s'affiche.Codes de retour :
200 (OK) : demande aboutie.403 (Forbidden) : l'accès à la ressource est refusé. 404 (Not Found) : la tâche avec l'identifiant spécifié est introuvable dans la base de données du Serveur d'intégration.