调用该接口查询设备统计数据。

请求参数

名称 类型 是否必需 描述
Action String 要执行的操作,取值:QueryDeviceStatistics
ProductKey String 要查询的设备所隶属的产品Key。
  • 传入产品Key,将返回该产品下的设备统计数据。
  • 不传入该参数,则返回账号下所有设备统计数据。
公共请求参数 - 请参见公共参数

返回参数

名称 类型 描述
RequestId String 阿里云为该请求生成的唯一标识符。
Success Boolean 表示是否调用成功。true表示调用成功,false表示调用失败。
ErrorMessage String 调用失败时,返回的出错信息。
Code String 调用失败时,返回的错误码。错误码详情,请参见错误码
Data Data 调用成功时,返回的设备统计信息。详情参见StatisticsInfo
表 1. StatisticsInfo
名称 类型 描述
deviceCount Integer 设备总数。
onlineCount Integer 在线的设备数量。
activeCount Integer 已激活的设备数量。

示例

请求示例

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceStatistics
&ProductKey=al**********
&公共请求参数

返回示例

  • JSON格式

    {
      "RequestId":"57b144cf-09fc-4916-a272-a62902d5b207",
      "Success": true,
      "Data": {
        "deviceCount": 100,
        "onlineCount": 10,
        "activeCount": 50
      }
    }
    
  • XML格式

    <?xml version='1.0' encoding='utf-8'?>
    <QueryDeviceStatisticsResponse>
        <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
        <Success>true</Success>
        <Data>
            <deviceCount>100</deviceCount>
            <onlineCount>10</onlineCount>
            <activeCount>50</activeCount>
        </Data>
    </QueryDeviceStatisticsResponse>