调用该接口查询指定设备上传到物联网平台的指定文件信息。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作,取值:QueryDeviceFile
IotId String 要查询的设备ID,设备唯一标识符。
说明 如果传入该参数,则无需传入 ProductKey和 DeviceName。IotId作为设备唯一标识符,和 ProductKey与 DeviceName组合是一一对应的关系。如果您同时传入 IotId和 ProductKey与 DeviceName组合,则以 IotId为准。不能传入空参数。
ProductKey String 要查询的设备所隶属的产品Key。
说明 如果传入该参数,需同时传入 DeviceName。
DeviceName String 要查询的设备的名称。
说明 如果传入该参数,需同时传入 ProductKey。
FileId String 文件标识符。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 调用失败时,返回的错误码。错误码详情,请参见错误码
Data Data 调用成功时,返回的文件信息。详情参见下表Data
表 1. Data
名称 类型 描述
FileId String 文件标识符。
Name String 文件名。
Size String 文件大小。
UtcCreatedOn String 文件创建时间。
DownloadUrl String 文件下载URL。

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceFile
&ProductKey=al********
&DeviceName=deviceName1
&FileId=6UCo1SqbqnQEoh9aKqD******
&公共请求参数

返回示例

  • JSON格式
    {
      "RequestId": "93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F",
      "Data": {
        "Name": "testFile3.txt",
        "DownloadUrl": "http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849E4E5CFF64804A18D9384AC9D****/aGEKIpp5NAGxdP2oo90000****/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAIYLScbHiV****&Signature=%2F88xdEFPukJ****%2F8****%2Bdv3io%3D",
        "FileId": "6UCo1SqbqnQEoh9aKqDQ01****",
        "UtcCreatedOn": "2019-03-21T08:45:42.000Z",
        "Size": "102400"
      },
      "Success": true
    }
  • XML格式
    <?xml version="1.0" encoding="UTF-8" ?>
    	<RequestId>93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F</RequestId>
    	<Data>
    		<Name>testFile3.txt</Name>
    		<DownloadUrl>http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849E4E5CFF64804A18D9384AC9D****/aGEKIpp5NAGxdP2oo90000****/testFile3.txt?Expires=1553162075&amp;OSSAccessKeyId=LTAIYLScbHiV****&amp;Signature=%2F88xdEFPukJ****%2F8****%2Bdv3io%3D</DownloadUrl>
    		<FileId>6UCo1SqbqnQEoh9aKqDQ01****</FileId>
    		<UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
    		<Size>102400</Size>
    	</Data>
    	<Success>true</Success>