# QueryDeviceStatistics

调用该接口查询设备统计数据,包括在线设备数、已激活设备数和已创建的设备总数。

# 请求参数

名称 类型 是否必选 示例值 描述
Action String QueryDeviceStatistics 系统规定参数。取值:QueryDeviceStatistics。
IotInstanceId String 6912917943269**** 实例ID。您可在物联网平台控制台的实例概览页面,查看当前实例的ID
ProductKey String a1BwAGV**** 要查询设备所属的产品ProductKey。传入此参数,返回该产品下的设备统计数据。

# 返回数据

名称 类型 示例值 描述
Code String iot.system.SystemException 调用失败时,返回的错误码。
Data Struct 调用成功时,返回的设备统计信息。
activeCount Long 10 已激活的设备数量。
deviceCount Long 100 设备总数。
onlineCount Long 10 在线的设备数量。
ErrorMessage String 系统异常 调用失败时,返回的出错信息。
RequestId String axdFFvS5AJ5ZxzzlAXvvbmyXI6yCjHQm 平台为该请求生成的唯一标识符。
Success Boolean true 表示是否调用成功。true:调用成功。false:调用失败。

# 示例

请求示例

http://open.${区域}.fenydata.com/fenydata-java-open/?Action=QueryDeviceStatistics
&ProductKey=a1BwAGV****
&IotInstanceId=70255861902711****
&<公共请求参数>

正常返回示例

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xml>
    <Data>
        <deviceCount>2</deviceCount>
        <activeCount>2</activeCount>
        <onlineCount>0</onlineCount>
    </Data>
    <RequestId>axdFFvS5AJ5ZxzzlAXvvbmyXI6yCjHQm</RequestId>
    <Success>true</Success>
</xml>

JSON格式

{
  "Data": {
    "deviceCount": 2,
    "activeCount": 2,
    "onlineCount": 0
  },
  "RequestId": "axdFFvS5AJ5ZxzzlAXvvbmyXI6yCjHQm",
  "Success": true
}