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

请求参数

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

返回参数

名称 类型 描述
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>