调用该接口查询指定设备上传到物联网平台的所有文件列表。

说明

调用该接口返回的文件信息中,不包括文件下载地址。如需获取文件下载地址,请调用QueryDeviceFile查询。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作,取值:QueryDeviceFileList
IotId String 要查询的设备ID,设备唯一标识符。
说明 如果传入该参数,则无需传入 ProductKey和 DeviceName。IotId作为设备唯一标识符,和 ProductKey与 DeviceName组合是一一对应的关系。如果您同时传入 IotId和 ProductKey与 DeviceName组合,则以 IotId为准。不能传入空参数。
ProductKey String 要查询的设备所隶属的产品Key。
说明 如果传入该参数,需同时传入 DeviceName。
DeviceName String 要查询的设备的名称。
说明 如果传入该参数,需同时传入 ProductKey。
PageSize Integer 返回结果中每页显示的文件记录数量。最大取值200,默认值是10。
CurrentPage Integer 显示返回结果中的第几页。最小取值1,默认值 1。
公共请求参数 - 请参见公共参数

返回参数

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

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceFileList
&ProductKey=al********
&DeviceName=deviceName1
&PageSize=10
&CurrentPage=1
&公共请求参数

返回示例

  • JSON格式
    {
      "PageCount": 1, 
      "Data": {
        "FileStoreSummary": [
          {
            "Name": "testFile2.txt", 
            "FileId": "xL0G67MBLBDtkR7GCfT******", 
            "UtcCreatedOn": "2019-03-21T08:45:42.000Z", 
            "Size": "102400"
          }, 
          {
            "Name": "testFile3.txt", 
            "FileId": "6UCo1SqbqnQEoh9aKqD******", 
            "UtcCreatedOn": "2019-03-21T08:45:42.000Z", 
            "Size": "102400"
          }, 
          {
            "Name": "testFile1.txt", 
            "FileId": "IhXXww3Eeu6uzSOSCyu******", 
            "UtcCreatedOn": "2019-03-21T08:45:40.000Z", 
            "Size": "102400"
          }
        ]
      }, 
      "PageSize": 10, 
      "RequestId": "7C7BA526-826D-46AA-A45E-55D21E6D1583", 
      "CurrentPage": 1, 
      "Success": true, 
      "Total": 3
    }
  • XML格式
    <?xml version="1.0" encoding="utf-8"?>
    <QueryDeviceFileListResponse>
     <PageCount>1</PageCount>
     <Data>
       <FileStoreSummary>
         <Name>testFile2.txt</Name>
         <FileId>xL0G67MBLBDtkR7GCfT******</FileId>
         <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
         <Size>102400</Size>
       </FileStoreSummary>
       <FileStoreSummary>
         <Name>testFile3.txt</Name>
         <FileId>6UCo1SqbqnQEoh9aKqD******</FileId>
         <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
         <Size>102400</Size>
       </FileStoreSummary>
       <FileStoreSummary>
         <Name>testFile1.txt</Name>
         <FileId>IhXXww3Eeu6uzSOSCyu******</FileId>
         <UtcCreatedOn>2019-03-21T08:45:40.000Z</UtcCreatedOn>
         <Size>102400</Size>
       </FileStoreSummary>
     </Data>
     <PageSize>10</PageSize>
     <RequestId>BF06F7FD-B199-4B90-9128-8416F975135E</RequestId>
     <CurrentPage>1</CurrentPage>
     <Success>true</Success>
     <Total>3</Total>
    </QueryDeviceFileListResponse>