查询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
}

错误码

错误码详细信息,请参见错误码