查询IoT数据源组下所有已上传数据的设备。

可访问账号：

业务管理方

业务使用方

√

√

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListDevice

系统规定参数。取值：ListDevice。
ApiVersion String 是 1.0.0

API版本号，"1.0.0"。
BizChainId String 是 489973087549****

业务链标识。
DeviceGroupId String 是 475020454741****

IoT数据源组标识。
Num Integer 是 1

指定显示返回结果中的第几页，最小取值是1。
Size Integer 是 2

指定返回结果中每页显示的记录数量，最大值是100。
IotId String 否 183329761572****

要查询IoT设备的ID。

说明 不传则查询该IoT数据源组下的所有IoT设备。

返回数据

名称 类型 示例值 描述
Code Integer 200

响应状态码。
Data Struct

响应内容。
Num Integer 1

页码。
PageData Array of DeviceInfo

数据项
DeviceId String 876055554040****

设备标识。
IotId String 183329761572****

IoT设备ID。
LastSaveTime Long 1606379090866

最后存证时间。毫秒级时间戳。
Status String AUTHORIZED

授权状态。

  • AUTHORIZED：已授权。
  • UNAUTHORIZED：未授权。
Size Integer 2

每页数量。
Total Integer 30

总条数。
Message String The system is busy. Please try again later.

调用失败时，返回的出错信息。
RequestId String D5C69894-9709-4653-B3D8-25234034C2FC

阿里云为该请求生成的唯一标识符。
Success Boolean true

是否调用成功。

  • true：调用成功。
  • false：调用失败。

示例

请求示例

http(s)://ltl.cn-shanghai.aliyuncs.com/?Action=ListDevice
&ApiVersion=1.0.0
&BizChainId=489973087549****
&DeviceGroupId=475020454741****
&Num=1
&Size=2
&<公共请求参数>

正常返回示例

XML 格式 

<ListDeviceResponse>
      <Message></Message>
      <RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
      <Data>
            <PageData>
                  <Status>AUTHORIZED</Status>
                  <IotId>183329761572****</IotId>
                  <LastSaveTime>1606379090866</LastSaveTime>
                  <DeviceId>876055554040****</DeviceId>
            </PageData>
            <PageData>
                  <Status>AUTHORIZED</Status>
                  <IotId>183329761573****</IotId>
                  <LastSaveTime>1606379090888</LastSaveTime>
                  <DeviceId>876055554041****</DeviceId>
            </PageData>
            <Size>2</Size>
            <Num>1</Num>
            <Total>30</Total>
      </Data>
      <Code>200</Code>
      <Success>true</Success>
</ListDeviceResponse>

JSON 格式 

{
    "Message": "",
    "RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
    "Data": {
        "PageData": [
            {
                "Status": "AUTHORIZED",
                "IotId": "183329761572****",
                "LastSaveTime": 1606379090866,
                "DeviceId": "876055554040****"
            },
            {
                "Status": "AUTHORIZED",
                "IotId": "183329761573****",
                "LastSaveTime": 1606379090888,
                "DeviceId": "876055554041****"
            }
        ],
        "Size": 2,
        "Num": 1,
        "Total": 30
    },
    "Code": 200,
    "Success": true
}

错误码

错误码详细信息，请参见错误码。