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.

# AWS Snowball Edge Device Management
<a name="API_Operations_AWS_Snow_Device_Management"></a>

Les actions suivantes sont prises en charge parAWS Snowball Edge Device Management :
+  [CancelTask](API_devicemanagement_CancelTask.md) 
+  [CreateTask](API_devicemanagement_CreateTask.md) 
+  [DescribeDevice](API_devicemanagement_DescribeDevice.md) 
+  [DescribeDeviceEc2Instances](API_devicemanagement_DescribeDeviceEc2Instances.md) 
+  [DescribeExecution](API_devicemanagement_DescribeExecution.md) 
+  [DescribeTask](API_devicemanagement_DescribeTask.md) 
+  [ListDeviceResources](API_devicemanagement_ListDeviceResources.md) 
+  [ListDevices](API_devicemanagement_ListDevices.md) 
+  [ListExecutions](API_devicemanagement_ListExecutions.md) 
+  [ListTagsForResource](API_devicemanagement_ListTagsForResource.md) 
+  [ListTasks](API_devicemanagement_ListTasks.md) 
+  [TagResource](API_devicemanagement_TagResource.md) 
+  [UntagResource](API_devicemanagement_UntagResource.md) 

# CancelTask
<a name="API_devicemanagement_CancelTask"></a>

Envoie une demande d'annulation pour une tâche spécifiée. Vous ne pouvez annuler une tâche que si elle se trouve toujours dans un`QUEUED`état. Les tâches déjà en cours ne peuvent pas être annulées.

**Note**  
Une tâche peut toujours être exécutée si elle est traitée à partir de la file d'attente avant le`CancelTask`l'opération modifie l'état de la tâche.

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

```
POST /task/taskId/cancel HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [taskId](#API_devicemanagement_CancelTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CancelTask-request-taskId"></a>
ID de la tâche que vous tentez d'annuler. Vous pouvez extraire un ID de tâche à l'aide de la`ListTasks`.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Obligatoire Oui

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

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

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

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

{
   "taskId": "string"
}
```

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

 ** [taskId](#API_devicemanagement_CancelTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CancelTask-response-taskId"></a>
ID de la tâche que vous tentez d'annuler.  
Type : Chaîne

## Erreurs
<a name="API_devicemanagement_CancelTask_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 unAWSservice.  
Code d'état HTTP : 400

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

# 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) 

# DescribeDevice
<a name="API_devicemanagement_DescribeDevice"></a>

Vérifie les informations spécifiques à l'appareil, telles que le type de périphérique, la version du logiciel, les adresses IP et l'état du verrouillage.

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

```
POST /managed-device/managedDeviceId/describe HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [managedDeviceId](#API_devicemanagement_DescribeDevice_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-request-managedDeviceId"></a>
ID de l'appareil sur lequel vous vérifiez les informations.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Obligatoire Oui

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

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

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

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

{
   "associatedWithJob": "string",
   "deviceCapacities": [ 
      { 
         "available": number,
         "name": "string",
         "total": number,
         "unit": "string",
         "used": number
      }
   ],
   "deviceState": "string",
   "deviceType": "string",
   "lastReachedOutAt": number,
   "lastUpdatedAt": number,
   "managedDeviceArn": "string",
   "managedDeviceId": "string",
   "physicalNetworkInterfaces": [ 
      { 
         "defaultGateway": "string",
         "ipAddress": "string",
         "ipAddressAssignment": "string",
         "macAddress": "string",
         "netmask": "string",
         "physicalConnectorType": "string",
         "physicalNetworkInterfaceId": "string"
      }
   ],
   "software": { 
      "installedVersion": "string",
      "installingVersion": "string",
      "installState": "string"
   },
   "tags": { 
      "string" : "string" 
   }
}
```

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

 ** [associatedWithJob](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-associatedWithJob"></a>
ID de la tâche utilisée lors de la commande de l'appareil.  
Type : Chaîne

 ** [deviceCapacities](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceCapacities"></a>
Les spécifications matérielles de l'appareil.   
Type : Tableau de[Capacity](API_devicemanagement_Capacity.md)objets  
Membres de tableau : Nombre minimal de 0 éléments. Nombre maximal de 100 éléments.

 ** [deviceState](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceState"></a>
Statut actuel de l'appareil.  
Type : Chaîne  
Valeurs valides :` UNLOCKED | LOCKED | UNLOCKING` 

 ** [deviceType](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceType"></a>
Le type deAWSAppareil Snow Family.  
Type : Chaîne

 ** [lastReachedOutAt](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-lastReachedOutAt"></a>
Lorsque l'appareil a contacté pour la dernière fois leAWS Cloud. Indique que l'appareil est en ligne.  
Type : Horodatage

 ** [lastUpdatedAt](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-lastUpdatedAt"></a>
Lorsque l'appareil a poussé une mise à jour pour la dernière fois sur leAWS Cloud. Indique quand le cache des périphériques a été actualisé.  
Type : Horodatage

 ** [managedDeviceArn](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-managedDeviceArn"></a>
Amazon Resource Name (ARN) de l'appareil.  
Type : Chaîne

 ** [managedDeviceId](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-managedDeviceId"></a>
ID de l'appareil pour lequel vous avez vérifié les informations.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.

 ** [physicalNetworkInterfaces](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-physicalNetworkInterfaces"></a>
Les interfaces réseau disponibles sur l'appareil.  
Type : Tableau de[PhysicalNetworkInterface](API_devicemanagement_PhysicalNetworkInterface.md)objets

 ** [software](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-software"></a>
Le logiciel installé sur l'appareil.  
Type : objet [SoftwareInformation](API_devicemanagement_SoftwareInformation.md)

 ** [tags](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-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

## Erreurs
<a name="API_devicemanagement_DescribeDevice_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.  
HTTP Status Code : 403

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

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

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

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

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

# DescribeDeviceEc2Instances
<a name="API_devicemanagement_DescribeDeviceEc2Instances"></a>

Vérifie l'état actuel des instances Amazon EC2. La sortie est similaire à`describeDevice`, mais les résultats proviennent du cache de périphériques dans leAWS Cloudet inclut un sous-ensemble des champs disponibles. 

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

```
POST /managed-device/managedDeviceId/resources/ec2/describe HTTP/1.1
Content-type: application/json

{
   "instanceIds": [ "string" ]
}
```

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

La demande utilise les paramètres URI suivants.

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

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

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

 ** [instanceIds](#API_devicemanagement_DescribeDeviceEc2Instances_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeDeviceEc2Instances-request-instanceIds"></a>
Liste des ID d'instance associés à l'appareil géré.  
Type : Tableau de chaînes  
Obligatoire Oui

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

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

{
   "instances": [ 
      { 
         "instance": { 
            "amiLaunchIndex": number,
            "blockDeviceMappings": [ 
               { 
                  "deviceName": "string",
                  "ebs": { 
                     "attachTime": number,
                     "deleteOnTermination": boolean,
                     "status": "string",
                     "volumeId": "string"
                  }
               }
            ],
            "cpuOptions": { 
               "coreCount": number,
               "threadsPerCore": number
            },
            "createdAt": number,
            "imageId": "string",
            "instanceId": "string",
            "instanceType": "string",
            "privateIpAddress": "string",
            "publicIpAddress": "string",
            "rootDeviceName": "string",
            "securityGroups": [ 
               { 
                  "groupId": "string",
                  "groupName": "string"
               }
            ],
            "state": { 
               "code": number,
               "name": "string"
            },
            "updatedAt": number
         },
         "lastUpdatedAt": number
      }
   ]
}
```

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

 ** [instances](#API_devicemanagement_DescribeDeviceEc2Instances_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDeviceEc2Instances-response-instances"></a>
Liste des structures contenant des informations sur chaque instance.   
Type : Tableau de[InstanceSummary](API_devicemanagement_InstanceSummary.md)objets

## Erreurs
<a name="API_devicemanagement_DescribeDeviceEc2Instances_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.  
HTTP Status Code : 403

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

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

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

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

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

# 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) 

# DescribeTask
<a name="API_devicemanagement_DescribeTask"></a>

Vérifie les métadonnées d'une tâche donnée sur un appareil. 

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

```
POST /task/taskId HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [taskId](#API_devicemanagement_DescribeTask_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-request-taskId"></a>
ID de la tâche à décrire.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Obligatoire Oui

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

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

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

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

{
   "completedAt": number,
   "createdAt": number,
   "description": "string",
   "lastUpdatedAt": number,
   "state": "string",
   "tags": { 
      "string" : "string" 
   },
   "targets": [ "string" ],
   "taskArn": "string",
   "taskId": "string"
}
```

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

 ** [completedAt](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-completedAt"></a>
Lorsque la tâche a été terminée.  
Type : Horodatage

 ** [createdAt](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-createdAt"></a>
Lorsque le`CreateTask`l'opération a été appelée.  
Type : Horodatage

 ** [description](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-description"></a>
Description fournie de la tâche et des appareils gérés.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 128.  
Modèle : `[A-Za-z0-9 _.,!#]*` 

 ** [lastUpdatedAt](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-lastUpdatedAt"></a>
Date et heure de la dernière mise à jour de l'état de la tâche.  
Type : Horodatage

 ** [state](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-state"></a>
État actuel de la tâche.  
Type : Chaîne  
Valeurs valides :` IN_PROGRESS | CANCELED | COMPLETED` 

 ** [tags](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-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

 ** [targets](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-targets"></a>
Les appareils gérés vers lesquels la tâche a été envoyée.  
Type : Tableau de chaînes  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 10 éléments.

 ** [taskArn](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-taskArn"></a>
Amazon Resource Name (ARN) de la tâche.  
Type : Chaîne

 ** [taskId](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-taskId"></a>
ID de la tâche  
Type : Chaîne

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

# ListDeviceResources
<a name="API_devicemanagement_ListDeviceResources"></a>

Renvoie une liste desAWSressources disponibles pour un appareil. Actuellement, les instances Amazon EC2 sont le seul type de ressource pris en charge.

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

```
GET /managed-device/managedDeviceId/resources?maxResults=maxResults&nextToken=nextToken&type=type HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [managedDeviceId](#API_devicemanagement_ListDeviceResources_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDeviceResources-request-managedDeviceId"></a>
ID de l'appareil géré dont vous répertoriez les ressources.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Obligatoire Oui

 ** [maxResults](#API_devicemanagement_ListDeviceResources_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDeviceResources-request-maxResults"></a>
Nombre maximal de ressources par page.  
Plage valide : Valeur minimale est 1. Valeur maximale fixée à 100.

 ** [nextToken](#API_devicemanagement_ListDeviceResources_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDeviceResources-request-nextToken"></a>
Un jeton de pagination pour passer à la page suivante des résultats.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

 ** [type](#API_devicemanagement_ListDeviceResources_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDeviceResources-request-type"></a>
Structure utilisée pour filtrer les résultats par type de ressource.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 50.

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

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

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

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

{
   "nextToken": "string",
   "resources": [ 
      { 
         "arn": "string",
         "id": "string",
         "resourceType": "string"
      }
   ]
}
```

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

 ** [nextToken](#API_devicemanagement_ListDeviceResources_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListDeviceResources-response-nextToken"></a>
Un jeton de pagination pour passer à la page suivante des résultats.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

 ** [resources](#API_devicemanagement_ListDeviceResources_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListDeviceResources-response-resources"></a>
Structure définissant le type de ressource, Amazon Resource Name (ARN) et son ID.  
Type : Tableau de[ResourceSummary](API_devicemanagement_ResourceSummary.md)objets

## Erreurs
<a name="API_devicemanagement_ListDeviceResources_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.  
HTTP Status Code : 403

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

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

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

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

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

# ListDevices
<a name="API_devicemanagement_ListDevices"></a>

Renvoie la liste de tous les appareils de votreCompte AWSqui ontAWSSnow Device Management activé dans leRégion AWSoù la commande est exécutée.

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

```
GET /managed-devices?jobId=jobId&maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [jobId](#API_devicemanagement_ListDevices_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDevices-request-jobId"></a>
L'ID de la tâche utilisée pour commander l'appareil.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.

 ** [maxResults](#API_devicemanagement_ListDevices_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDevices-request-maxResults"></a>
Nombre maximal d'appareils à mettre en vente par page.  
Plage valide : Valeur minimale est 1. Valeur maximale fixée à 100.

 ** [nextToken](#API_devicemanagement_ListDevices_RequestSyntax) **   <a name="Snowball-devicemanagement_ListDevices-request-nextToken"></a>
Jeton de pagination pour passer à la page suivante des résultats.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

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

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

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

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

{
   "devices": [ 
      { 
         "associatedWithJob": "string",
         "managedDeviceArn": "string",
         "managedDeviceId": "string",
         "tags": { 
            "string" : "string" 
         }
      }
   ],
   "nextToken": "string"
}
```

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

 ** [devices](#API_devicemanagement_ListDevices_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListDevices-response-devices"></a>
Liste des structures de périphériques contenant des informations sur l'appareil.  
Type : Tableau de[DeviceSummary](API_devicemanagement_DeviceSummary.md)objets

 ** [nextToken](#API_devicemanagement_ListDevices_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListDevices-response-nextToken"></a>
Jeton de pagination pour passer à la page suivante des appareils.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

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

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

# ListExecutions
<a name="API_devicemanagement_ListExecutions"></a>

Renvoie l'état des tâches d'une ou de plusieurs machines cibles.

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

```
GET /executions?maxResults=maxResults&nextToken=nextToken&state=state&taskId=taskId HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_devicemanagement_ListExecutions_RequestSyntax) **   <a name="Snowball-devicemanagement_ListExecutions-request-maxResults"></a>
Nombre maximal de tâches à répertorier par page.  
Plage valide : Valeur minimale est 1. Valeur maximale fixée à 100.

 ** [nextToken](#API_devicemanagement_ListExecutions_RequestSyntax) **   <a name="Snowball-devicemanagement_ListExecutions-request-nextToken"></a>
Jeton de pagination pour passer à la page suivante des tâches.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

 ** [state](#API_devicemanagement_ListExecutions_RequestSyntax) **   <a name="Snowball-devicemanagement_ListExecutions-request-state"></a>
Structure utilisée pour filtrer les tâches en fonction de leur état actuel.  
Valeurs valides :` QUEUED | IN_PROGRESS | CANCELED | FAILED | SUCCEEDED | REJECTED | TIMED_OUT` 

 ** [taskId](#API_devicemanagement_ListExecutions_RequestSyntax) **   <a name="Snowball-devicemanagement_ListExecutions-request-taskId"></a>
ID de la tâche  
Contraintes de longueur : Longueur minimale de 1. Longueur maximale de 64.  
Obligatoire Oui

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

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

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

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

{
   "executions": [ 
      { 
         "executionId": "string",
         "managedDeviceId": "string",
         "state": "string",
         "taskId": "string"
      }
   ],
   "nextToken": "string"
}
```

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

 ** [executions](#API_devicemanagement_ListExecutions_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListExecutions-response-executions"></a>
Une liste d'exécutions. Chaque exécution contient l'ID de la tâche, le périphérique sur lequel la tâche est exécutée, l'ID d'exécution et l'état de l'exécution.  
Type : Tableau de[ExecutionSummary](API_devicemanagement_ExecutionSummary.md)objets

 ** [nextToken](#API_devicemanagement_ListExecutions_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListExecutions-response-nextToken"></a>
Jeton de pagination pour passer à la page suivante des exécutions.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

## Erreurs
<a name="API_devicemanagement_ListExecutions_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.  
HTTP Status Code : 403

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

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

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

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

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

# ListTagsForResource
<a name="API_devicemanagement_ListTagsForResource"></a>

Renvoie une liste de balises pour un appareil ou une tâche géré.

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

```
GET /tags/resourceArn HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_devicemanagement_ListTagsForResource_RequestSyntax) **   <a name="Snowball-devicemanagement_ListTagsForResource-request-resourceArn"></a>
Amazon Resource Name (ARN) de l'appareil ou de la tâche.  
Obligatoire Oui

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

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

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

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

{
   "tags": { 
      "string" : "string" 
   }
}
```

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

 ** [tags](#API_devicemanagement_ListTagsForResource_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListTagsForResource-response-tags"></a>
Liste des balises de l'appareil ou de la tâche.  
Type : Mappage chaîne/chaîne

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

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

 ** InternalServerException **   
Une erreur inattendue s'est produite pendant le 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

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

# ListTasks
<a name="API_devicemanagement_ListTasks"></a>

Renvoie la liste des tâches pouvant être filtrées par état.

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

```
GET /tasks?maxResults=maxResults&nextToken=nextToken&state=state HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [maxResults](#API_devicemanagement_ListTasks_RequestSyntax) **   <a name="Snowball-devicemanagement_ListTasks-request-maxResults"></a>
Nombre maximal de tâches par page.  
Plage valide : Valeur minimale est 1. Valeur maximale fixée à 100.

 ** [nextToken](#API_devicemanagement_ListTasks_RequestSyntax) **   <a name="Snowball-devicemanagement_ListTasks-request-nextToken"></a>
Jeton de pagination pour passer à la page suivante des tâches.  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

 ** [state](#API_devicemanagement_ListTasks_RequestSyntax) **   <a name="Snowball-devicemanagement_ListTasks-request-state"></a>
Structure utilisée pour filtrer la liste des tâches.  
Valeurs valides :` IN_PROGRESS | CANCELED | COMPLETED` 

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

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

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

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

{
   "nextToken": "string",
   "tasks": [ 
      { 
         "state": "string",
         "tags": { 
            "string" : "string" 
         },
         "taskArn": "string",
         "taskId": "string"
      }
   ]
}
```

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

 ** [nextToken](#API_devicemanagement_ListTasks_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListTasks-response-nextToken"></a>
Jeton de pagination pour passer à la page suivante des tâches.  
Type : Chaîne  
Contraintes de longueur : Longueur minimale de 1. Longueur maximum de 1024.  
Modèle : `[a-zA-Z0-9+/=]*` 

 ** [tasks](#API_devicemanagement_ListTasks_ResponseSyntax) **   <a name="Snowball-devicemanagement_ListTasks-response-tasks"></a>
Liste des structures de tâches contenant des détails sur chaque tâche.  
Type : Tableau de[TaskSummary](API_devicemanagement_TaskSummary.md)objets

## Erreurs
<a name="API_devicemanagement_ListTasks_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 pendant le traitement de la demande.  
Code d'état HTTP : 500

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

# TagResource
<a name="API_devicemanagement_TagResource"></a>

Ajoute ou remplace des balises sur un appareil ou une tâche.

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

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

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

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_devicemanagement_TagResource_RequestSyntax) **   <a name="Snowball-devicemanagement_TagResource-request-resourceArn"></a>
Amazon Resource Name (ARN) de l'appareil ou de la tâche.  
Obligatoire Oui

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

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

 ** [tags](#API_devicemanagement_TagResource_RequestSyntax) **   <a name="Snowball-devicemanagement_TagResource-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 Oui

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

```
HTTP/1.1 200
```

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

Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

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

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

 ** 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

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

# UntagResource
<a name="API_devicemanagement_UntagResource"></a>

Supprime une balise d'un appareil ou d'une tâche.

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

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [resourceArn](#API_devicemanagement_UntagResource_RequestSyntax) **   <a name="Snowball-devicemanagement_UntagResource-request-resourceArn"></a>
Amazon Resource Name (ARN) de l'appareil ou de la tâche.  
Obligatoire Oui

 ** [tagKeys](#API_devicemanagement_UntagResource_RequestSyntax) **   <a name="Snowball-devicemanagement_UntagResource-request-tagKeys"></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.  
Obligatoire Oui

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

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

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

```
HTTP/1.1 200
```

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

Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

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

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

 ** InternalServerException **   
Une erreur inattendue s'est produite pendant le 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

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