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.

# CreateTask
<a name="API_devicemanagement_CreateTask"></a>

Indique à un ou plusieurs appareils de démarrer une tâche, comme le déverrouillage ou le redémarrage.

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

```
POST /task HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "command": { 
      "reboot": { 
      },
      "unlock": { 
      }
   },
   "description": "string",
   "tags": { 
      "string" : "string" 
   },
   "targets": [ "string" ]
}
```

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

La demande n’utilise pas de paramètres URI.

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

Cette demande accepte les données suivantes au format JSON.

 ** [clientToken](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-clientToken"></a>
Un jeton garantissant que l'action n'est appelée qu'une seule fois avec les détails spécifiés.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Modèle : `[!-~]+`   
Obligatoire Non

 ** [command](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-command"></a>
La tâche à effectuer. Une seule tâche est exécutée sur un appareil à la fois.  
Type : objet [Command](API_devicemanagement_Command.md)  
Obligatoire Oui

 ** [description](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-description"></a>
Description de la tâche et de ses objectifs.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 128.  
Modèle : `[A-Za-z0-9 _.,!#]*`   
Obligatoire Non

 ** [tags](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-tags"></a>
Métadonnées facultatives que vous affectez à une ressource. Les balises vous permettent de classer une ressource de différentes façons, par exemple, par objectif, par propriétaire ou par environnement.   
Type : Mappage chaîne/chaîne  
Obligatoire Non

 ** [targets](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-targets"></a>
Liste des ID d'appareils gérés.  
Type : Tableau de chaînes  
Membres de tableau : Nombre minimum de 1 élément. Nombre maximum de 10 éléments.  
Obligatoire Oui

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

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

{
   "taskArn": "string",
   "taskId": "string"
}
```

## Eléments de réponse
<a name="API_devicemanagement_CreateTask_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.

 ** [taskArn](#API_devicemanagement_CreateTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CreateTask-response-taskArn"></a>
Amazon Resource Name (ARN) de la tâche que vous avez créée.  
Type : Chaîne

 ** [taskId](#API_devicemanagement_CreateTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CreateTask-response-taskId"></a>
ID de la tâche que vous avez créée.  
Type : Chaîne

## Erreurs
<a name="API_devicemanagement_CreateTask_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

 ** ServiceQuotaExceededException **   
La demande entraînerait le dépassement d'un quota de service.  
Code d'état HTTP : 402

 ** 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 unAWSservice.  
Code d'état HTTP : 400

## Voir aussi
<a name="API_devicemanagement_CreateTask_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/CreateTask) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snow-device-management-2021-08-04/CreateTask) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/CreateTask) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snow-device-management-2021-08-04/CreateTask) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/CreateTask) 
+  [Kit AWS SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/CreateTask) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/CreateTask)