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.

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