# 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
}
← 批量查看指定设备的运行状态 删除指定设备 →