Get Device Statistics¶
获取特定组织或产品下设备统计信息。
请求格式¶
GET https://{apigw-address}/connect-service/v2.1/devices?action=getStats
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
资产所属的组织ID。 如何获取 orgId 信息>> |
productKey |
Query |
可选 |
String |
设备的 Product Key。如未指定,将获取组织下设备统计信息。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
DeviceStats 结构体 |
设备的统计信息。结构体的结构参见 DeviceStats 结构体>>。 |
DeviceStats 结构体 ¶
名称 |
数据类型 |
描述 |
---|---|---|
totalCount |
Integer |
设备总数。 |
onlineCount |
Integer |
在线设备数。 |
offlineCount |
Integer |
离线设备数。 |
inactiveCount |
Integer |
未激活设备数。 |
disabledCount |
Integer |
禁用设备数。 |
示例¶
请求示例¶
url: https://{apigw-address}/connect-service/v2.1/devices?action=getStats&orgId=yourOrgId&productKey=yourProductKey
method: GET
返回示例¶
{
"code":0,
"msg":"OK",
"requestId":"21e4f294-824b-4eb5-913d-2ca92a230a71",
"data": {
"totalCount":100,
"onlineCount":46,
"offlineCount":24,
"inactiveCount":26,
"disabledCount":4
}
}
Java SDK 调用示例¶
package com.envisioniot.enos.connect_service;
import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;
import com.envisioniot.enos.connect_service.v2_1.device.GetDeviceStatsRequest;
import com.envisioniot.enos.connect_service.v2_1.device.GetDeviceStatsResponse;
public class GetDeviceStats {
public static void main(String[] args) {
String appKey = "yourAppKey";
String appSecret = "yourAppSecret";
String serverUrl = "yourServerUrl";
String orgId = "yourOrgId";
GetDeviceStatsRequest request = new GetDeviceStatsRequest();
request.setOrgId(orgId);
request.setProductKey("yourProductKey");
GetDeviceStatsResponse response = Poseidon.config(PConfig.init().appKey(appKey).appSecret(appSecret).debug())
.url(serverUrl)
.getResponse(request, GetDeviceStatsResponse.class);
}
}