DescribeDevice - AWS Snowball
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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

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

Anforderungssyntax

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

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

managedDeviceId

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

Der Anforderung besitzt keinen Anforderungstext.

Antwortsyntax

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

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

Die ID des Auftrags, der bei der Bestellung des Geräts verwendet wurde.

Type: String (Zeichenfolge)

deviceCapacities

Die Hardwarespezifikationen des Geräts.

Type: Array vonCapacityObjekte

Array-Mitglieder: Minimale Anzahl der Elemente: 0. Die maximale Anzahl beträgt 100 Elemente.

deviceState

Der aktuelle Status des Geräts.

Type: String (Zeichenfolge)

Zulässige Werte: UNLOCKED | LOCKED | UNLOCKING

deviceType

Die Art vonAWSSnow-Familien-Gerät.

Type: String (Zeichenfolge)

lastReachedOutAt

Als das Gerät das letzte Mal denAWS Cloudaus. Zeigt an, dass das Gerät online ist.

Type: Zeitstempel

lastUpdatedAt

Als das Gerät zuletzt ein Update auf dieAWS Cloudaus. Zeigt an, wann der Gerätecache aktualisiert wurde.

Type: Zeitstempel

managedDeviceArn

Der Amazon-Ressourcenname (ARN) des Geräts.

Type: String (Zeichenfolge)

managedDeviceId

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

Die auf dem Gerät verfügbaren Netzwerkschnittstellen.

Type: Array vonPhysicalNetworkInterfaceObjekte

software

Die auf dem Gerät installierte Software.

Typ: SoftwareInformation Objekt

tags

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

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehleraus.

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:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: