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