QueryDeviceFile - IoT Platform - Centro de documentación de Alibaba Cloud

Consulta la información de un archivo específico cargado desde un dispositivo a IoT Platform.

Límites

Máximo 500 QPS por cuenta de Alibaba Cloud.

Nota

Los usuarios de RAM comparten la cuota de la cuenta.

Depuración

OpenAPI Explorer calcula automáticamente las firmas y genera código de ejemplo del SDK. Se recomienda llamar a esta operación en OpenAPI Explorer.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	QueryDeviceFile	Operación a ejecutar. Establezca el valor en QueryDeviceFile.
FileId	String	Sí	xL0G67MBLBDtkR7GCfT	ID del archivo. Llame a QueryDeviceFileList para obtener los ID de archivo.
IotInstanceId	String	No	iot_instc_pu*_c-v64	ID de la instancia. Encuéntrelo en la página Descripción general de la consola de IoT Platform. Importante Obligatorio si su instancia tiene un ID. La llamada falla sin este valor. No es obligatorio si su instancia no tiene página de Descripción general ni ID. Descripción general.
ProductKey	String	No	a1BwAGV****	ProductKey del producto al que pertenece el dispositivo. Nota Si especifica este parámetro, también debe especificar el parámetro DeviceName.
DeviceName	String	No	light	Nombre del dispositivo. Nota Si especifica este parámetro, también debe especificar el parámetro ProductKey.
IotId	String	No	Q7uOhVRdZRRlDnTLv****00100	ID del dispositivo asignado por IoT Platform. Nota IotId es un GUID que corresponde a una combinación de ProductKey y DeviceName. Si se especifica, no son necesarios ProductKey ni DeviceName. Si se indican tanto IotId como la combinación ProductKey/DeviceName, IotId tiene prioridad.

También debe especificar los parámetros de solicitud comunes al llamar a esta operación.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
Code	String	iot.system.SystemException	Código de error devuelto en caso de fallo. Códigos de error.
Data	Struct		Información del archivo devuelta en caso de éxito.
DownloadUrl	String	http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849/aGE/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI&Signature=%2F8	URL de descarga del archivo.
FileId	String	6UCo1SqbqnQEoh9aKqDQ01****	ID del archivo.
Name	String	testFile3.txt	Nombre del archivo.
Size	String	102400	Tamaño del archivo en KB.
UtcCreatedOn	String	2019-03-21T08:45:42.000Z	Hora de creación del archivo en formato UTC.
ErrorMessage	String	A system exception occurred.	Mensaje de error devuelto en caso de fallo.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la solicitud.
Success	Boolean	true	Indica si la llamada se realizó correctamente. true: La llamada fue exitosa. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceFile
&ProductKey=a1BwAGV****
&DeviceName=deviceName1
&FileId=6UCo1SqbqnQEoh9aKqD******
&<Common request parameters>

Respuestas de ejemplo

Formato XML

<QueryDeviceFileResponse>
  <RequestId>93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F</RequestId>
  <Data>
        <Name>testFile3.txt</Name>
        <DownloadUrl>http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849******/aGE******/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI****************&Signature=%2F8******</DownloadUrl>
        <FileId>6UCo1SqbqnQEoh9aKqDQ01****</FileId>
        <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
        <Size>102400</Size>
  </Data>
  <Success>true</Success>
</QueryDeviceFileResponse>

Formato JSON

{
  "RequestId": "93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F",
  "Data": {
    "Name": "testFile3.txt",
    "DownloadUrl": "http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849******/aGE******/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI****************&Signature=%2F8******",
    "FileId": "6UCo1SqbqnQEoh9aKqDQ01****",
    "UtcCreatedOn": "2019-03-21T08:45:42.000Z",
    "Size": "102400"
  },
  "Success": true
}

Códigos de error

Visite el Centro de errores de API para consultar los códigos de error.