Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
DescribeDevice
Comprueba la información específica del dispositivo, como el tipo de dispositivo, la versión del software, las direcciones IP y el estado del bloqueo.
Sintaxis de la solicitud
POST /managed-device/managedDeviceId/describe HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- managedDeviceId
-
El ID del dispositivo cuya información está comprobando.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Obligatorio: sí
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
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"
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- associatedWithJob
-
El ID del trabajo utilizado al pedir el dispositivo.
Tipo: cadena
- deviceCapacities
-
Las especificaciones de hardware del dispositivo.
Tipo: matriz de objetos Capacity
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 100 artículos.
- deviceState
-
El estado actual del dispositivo.
Tipo: cadena
Valores válidos:
UNLOCKED | LOCKED | UNLOCKING - deviceType
-
El tipo de dispositivo de AWS la familia Snow.
Tipo: cadena
- lastReachedOutAt
-
La última vez que el dispositivo contactó con Nube de AWS. Indica que el dispositivo está en línea.
Tipo: marca temporal
- lastUpdatedAt
-
La última vez que el dispositivo envió una actualización a Nube de AWS. Indica cuándo se actualizó la memoria caché del dispositivo.
Tipo: marca temporal
- managedDeviceArn
-
El Nombre de recurso de Amazon (ARN) del dispositivo.
Tipo: cadena
- managedDeviceId
-
El ID del dispositivo cuya información ha comprobado.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
- physicalNetworkInterfaces
-
Las interfaces de red disponibles en el dispositivo.
Tipo: matriz de objetos PhysicalNetworkInterface
- software
-
El software instalado en el dispositivo.
Tipo: objeto SoftwareInformation
-
Metadatos opcionales que se asignan a un recurso. Las etiquetas permiten clasificar los recursos de diversas maneras, por ejemplo, según la finalidad, el propietario o el entorno.
Tipo: mapa de cadena a cadena
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403
- InternalServerException
-
Se ha producido un error inesperado al procesar la solicitud.
Código de estado HTTP: 500
- ResourceNotFoundException
-
La solicitud hace referencia a un recurso que no existe.
Código de estado HTTP: 404
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
Código de estado HTTP: 429
- ValidationException
-
La entrada no cumple las restricciones especificadas por un AWS servicio.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
