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