Get Device Statistics¶

获取特定组织或产品下设备统计信息。

操作权限¶

需授权的资源	所需操作权限
设备管理	Read

请求格式¶

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);
    }
}