Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# DescribeExecution
<a name="API_devicemanagement_DescribeExecution"></a>

Vérifie l'état d'une tâche distante exécutée sur une ou plusieurs machines cibles.

## Syntaxe de la demande
<a name="API_devicemanagement_DescribeExecution_RequestSyntax"></a>

```
POST /task/taskId/execution/managedDeviceId HTTP/1.1
```

## Paramètres de demande URI
<a name="API_devicemanagement_DescribeExecution_RequestParameters"></a>

La demande utilise les paramètres URI suivants.

 ** [managedDeviceId](#API_devicemanagement_DescribeExecution_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-request-managedDeviceId"></a>
ID de l'appareil géré.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Regatoire : Oui

 ** [taskId](#API_devicemanagement_DescribeExecution_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-request-taskId"></a>
ID de la tâche que l'action décrit.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Regatoire : Oui

## Corps de la demande
<a name="API_devicemanagement_DescribeExecution_RequestBody"></a>

La demande n’a pas de corps de requête.

## Syntaxe de la réponse
<a name="API_devicemanagement_DescribeExecution_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "executionId": "string",
   "lastUpdatedAt": number,
   "managedDeviceId": "string",
   "startedAt": number,
   "state": "string",
   "taskId": "string"
}
```

## Eléments de réponse
<a name="API_devicemanagement_DescribeExecution_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [executionId](#API_devicemanagement_DescribeExecution_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-response-executionId"></a>
ID de l'exécution.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.

 ** [lastUpdatedAt](#API_devicemanagement_DescribeExecution_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-response-lastUpdatedAt"></a>
Date et heure de la dernière mise à jour du statut de l'exécution.  
Type : Horodatage

 ** [managedDeviceId](#API_devicemanagement_DescribeExecution_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-response-managedDeviceId"></a>
ID du périphérique géré sur lequel la tâche est exécutée.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.

 ** [startedAt](#API_devicemanagement_DescribeExecution_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-response-startedAt"></a>
Quand l'exécution a commencé.  
Type : Horodatage

 ** [state](#API_devicemanagement_DescribeExecution_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-response-state"></a>
État actuel de l'exécution.  
Type : Chaîne  
Valeurs valides :` QUEUED | IN_PROGRESS | CANCELED | FAILED | SUCCEEDED | REJECTED | TIMED_OUT` 

 ** [taskId](#API_devicemanagement_DescribeExecution_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeExecution-response-taskId"></a>
ID de la tâche en cours d'exécution sur l'appareil.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.

## Erreurs
<a name="API_devicemanagement_DescribeExecution_Errors"></a>

Pour plus d'informations sur les erreurs communes à toutes les actions, voir[Erreurs courantes](CommonErrors.md).

 ** AccessDeniedException **   
Vous ne disposez pas d'un accès suffisant pour effectuer cette action.  
Code d'état HTTP : 403

 ** InternalServerException **   
Une erreur inattendue s'est produite lors du traitement de la demande.  
Code d'état HTTP : 500

 ** ResourceNotFoundException **   
La demande fait référence à une ressource qui n'existe pas.  
Code d'état HTTP : 404

 ** ThrottlingException **   
La demande a été refusée suite à une limitation des demandes.  
Code d'état HTTP : 429

 ** ValidationException **   
L'entrée ne satisfait pas les contraintes spécifiées par uneAWSservice.  
Code d'état HTTP : 400

## Voir aussi
<a name="API_devicemanagement_DescribeExecution_SeeAlso"></a>

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/snow-device-management-2021-08-04/DescribeExecution) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snow-device-management-2021-08-04/DescribeExecution) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/DescribeExecution) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snow-device-management-2021-08-04/DescribeExecution) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/DescribeExecution) 
+  [Kit AWS SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snow-device-management-2021-08-04/DescribeExecution) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/DescribeExecution) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/DescribeExecution) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/DescribeExecution)