Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Überprüft gerätespezifische Informationen wie Gerätetyp, Softwareversion, IP-Adressen und Sperrstatus.

## Anforderungssyntax
<a name="API_devicemanagement_DescribeDevice_RequestSyntax"></a>

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

## URI-Anfrageparameter
<a name="API_devicemanagement_DescribeDevice_RequestParameters"></a>

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [managedDeviceId](#API_devicemanagement_DescribeDevice_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-request-managedDeviceId"></a>
Die ID des Geräts, von dem Sie die Informationen überprüfen.  
Einschränkungen der Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen.  
Erforderlich: Ja

## Anforderungstext
<a name="API_devicemanagement_DescribeDevice_RequestBody"></a>

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<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" 
   }
}
```

## Antwortelemente
<a name="API_devicemanagement_DescribeDevice_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [associatedWithJob](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-associatedWithJob"></a>
Die ID des Auftrags, der bei der Bestellung des Geräts verwendet wurde.  
Type: String (Zeichenfolge)

 ** [deviceCapacities](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceCapacities"></a>
Die Hardwarespezifikationen des Geräts.   
Type: Array von[Capacity](API_devicemanagement_Capacity.md)Objekte  
Array-Mitglieder: Minimale Anzahl der Elemente: 0. Die maximale Anzahl beträgt 100 Elemente.

 ** [deviceState](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceState"></a>
Der aktuelle Status des Geräts.  
Type: String (Zeichenfolge)  
Zulässige Werte:` UNLOCKED | LOCKED | UNLOCKING` 

 ** [deviceType](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-deviceType"></a>
Die Art vonAWSSnow-Familien-Gerät.  
Type: String (Zeichenfolge)

 ** [lastReachedOutAt](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-lastReachedOutAt"></a>
Als das Gerät das letzte Mal denAWS Cloudaus. Zeigt an, dass das Gerät online ist.  
Type: Zeitstempel

 ** [lastUpdatedAt](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-lastUpdatedAt"></a>
Als das Gerät zuletzt ein Update auf dieAWS Cloudaus. Zeigt an, wann der Gerätecache aktualisiert wurde.  
Type: Zeitstempel

 ** [managedDeviceArn](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-managedDeviceArn"></a>
Der Amazon-Ressourcenname (ARN) des Geräts.  
Type: String (Zeichenfolge)

 ** [managedDeviceId](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-managedDeviceId"></a>
Die ID des Geräts, für das Sie die Informationen überprüft haben.  
Type: String (Zeichenfolge)  
Einschränkungen der Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen.

 ** [physicalNetworkInterfaces](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-physicalNetworkInterfaces"></a>
Die auf dem Gerät verfügbaren Netzwerkschnittstellen.  
Type: Array von[PhysicalNetworkInterface](API_devicemanagement_PhysicalNetworkInterface.md)Objekte

 ** [software](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-software"></a>
Die auf dem Gerät installierte Software.  
Typ: [SoftwareInformation](API_devicemanagement_SoftwareInformation.md) Objekt

 ** [tags](#API_devicemanagement_DescribeDevice_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDevice-response-tags"></a>
Optionale Metadaten, die Sie einer Ressource zuweisen. Mithilfe von Tags können Sie eine Ressource unterschiedlich kategorisieren, beispielsweise nach Zweck, Besitzer oder Umgebung.   
Type: Zeichenfolge-zu-Zeichenfolge-Zuweisung

## Fehler
<a name="API_devicemanagement_DescribeDevice_Errors"></a>

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter[Häufige Fehler](CommonErrors.md)aus.

 ** AccessDeniedException **   
Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.  
HTTP-Statuscode: 403

 ** InternalServerException **   
Bei der Verarbeitung der Anforderung ist ein unerwarteter Fehler aufgetreten.  
HTTP-Statuscode: 500

 ** ResourceNotFoundException **   
Die Anforderung verweist auf eine Ressource, die nicht vorhanden ist.  
HTTP-Statuscode: 404

 ** ThrottlingException **   
Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.  
HTTP-Statuscode: 429

 ** ValidationException **   
Die Eingabe erfüllt nicht die von einemAWSService-Service.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_devicemanagement_DescribeDevice_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS-SDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/DescribeDevice) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/DescribeDevice)