Cisco Evolved Programmable Network Manager API
Evolved Programmable Network Manager API Documentation

GET HistoricalClientCounts

Resource Information

Rate Limiting?

Yes

Sorting?

Yes

Paging?

Yes

Filtering?

Yes

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

Represents client count collected in last 24 hours with 5 minutes (default) interval. The dataset could be really big. When querying, you must use paged query or filtered by entity or time. Otherwise it could result in longer running query to affect system performance.

Since Product Version: 1.2

Resource URL

/webacs/api/v1/data/HistoricalClientCounts

Response Parameters

Type Attribute Name Description

int

authCount

total authenticated client count on the element in last collection time

long

collectionTime

The time collection of this record was finished, measured in milliseconds since the Unix epoch.

int

count

total client count on the element in last collection time

int

dot11aAuthCount

number of authenticated clients using 802.11a

int

dot11aCount

number of clients using 802.11a

int

dot11acAuthCount

number of authenticated clients using 802.11ac

int

dot11acCount

number of clients using 802.11ac

int

dot11bAuthCount

number of authenticated clients using 802.11b

int

dot11bCount

number of clients using 802.11b

int

dot11gAuthCount

number of authenticated clients using 802.11g

int

dot11gCount

number of clients using 802.11g

int

dot11n2_4AuthCount

number of authenticated clients using 802.11n on 2.4 GHz band

int

dot11n2_4Count

number of clients using 802.11n in 2.4 GHz band

int

dot11n5AuthCount

number of authenticated clients using 802.11n on 5 GHz band

int

dot11n5Count

number of clients using 802.11n in 5GHz band

String

instanceUuid

This is a uuid for this instance.

String

key

key represents the element

String

subkey

subkey is used to further categorize client count

ClientCountTypeEnum

type

Type of count element

Allowed values:

  • DEVICE
  • ACCESSPOINT
  • MAPLOCATION
  • SSID
  • VIRTUALDOMAIN
  • GUEST

int

wgbAuthCount

number of authenticated clients connected as WGB or wired guest

int

wgbCount

number of clients connected as WGB or wired guest

int

wired100MAuthCount

number of authenticated wired clients connected to wired switch on 100Mbps port

int

wired100MCount

number of wired clients connected to wired switch on 100Mbps port

int

wired10MAuthCount

number of authenticated wired clients connected to wired switch on 10Mbps port

int

wired10MCount

number of wired clients connected to wired switch on 10Mbps port

int

wired1GAuthCount

number of authenticated wired clients connected to wired switch on 1Gbps port

int

wired1GCount

number of wired clients connected to wired switch on 1Gbps port

Sample Payloads

Sample payloads are for information only. They are automatically generated and the values included may not be representative of actual valid data values.

Sample XML Payload

https://172.25.123.114/webacs/api/v1/data/HistoricalClientCounts/15

<?xml version="1.0" ?>
<queryResponse type="HistoricalClientCounts" responseType="getEntity" requestUrl="https://172.25.123.114/webacs/api/v1/data/HistoricalClientCounts/15" rootUrl="https://172.25.123.114/webacs/api/v1/data">
  <entity dtoType="historicalClientCountsDTO" type="HistoricalClientCounts" url="https://172.25.123.114/webacs/api/v1/data/HistoricalClientCounts/15">
    <historicalClientCountsDTO displayName="String value" id="15" uuid="String value">
      <authCount>1</authCount>
      <collectionTime>2</collectionTime>
      <count>1</count>
      <dot11aAuthCount>1</dot11aAuthCount>
      <dot11aCount>1</dot11aCount>
      <dot11acAuthCount>1</dot11acAuthCount>
      <dot11acCount>1</dot11acCount>
      <dot11bAuthCount>1</dot11bAuthCount>
      <dot11bCount>1</dot11bCount>
      <dot11gAuthCount>1</dot11gAuthCount>
      <dot11gCount>1</dot11gCount>
      <dot11n2_4AuthCount>1</dot11n2_4AuthCount>
      <dot11n2_4Count>1</dot11n2_4Count>
      <dot11n5AuthCount>1</dot11n5AuthCount>
      <dot11n5Count>1</dot11n5Count>
      <key>String value</key>
      <subkey>String value</subkey>
      <type>DEVICE</type>
      <wgbAuthCount>1</wgbAuthCount>
      <wgbCount>1</wgbCount>
      <wired100MAuthCount>1</wired100MAuthCount>
      <wired100MCount>1</wired100MCount>
      <wired10MAuthCount>1</wired10MAuthCount>
      <wired10MCount>1</wired10MCount>
      <wired1GAuthCount>1</wired1GAuthCount>
      <wired1GCount>1</wired1GCount>
    </historicalClientCountsDTO>
  </entity>
</queryResponse>

Sample JSON Payload

https://172.25.123.114/webacs/api/v1/data/HistoricalClientCounts/15.json

{
  "queryResponse" : {
    "@type" : "HistoricalClientCounts",
    "@responseType" : "getEntity",
    "@requestUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data\/HistoricalClientCounts\/15",
    "@rootUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data",
    "entity" : {
      "@dtoType" : "historicalClientCountsDTO",
      "@type" : "HistoricalClientCounts",
      "@url" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/data\/HistoricalClientCounts\/15",
      "historicalClientCountsDTO" : {
        "@displayName" : "String value",
        "@id" : "15",
        "@uuid" : "String value",
        "authCount" : 1,
        "collectionTime" : 2,
        "count" : 1,
        "dot11aAuthCount" : 1,
        "dot11aCount" : 1,
        "dot11acAuthCount" : 1,
        "dot11acCount" : 1,
        "dot11bAuthCount" : 1,
        "dot11bCount" : 1,
        "dot11gAuthCount" : 1,
        "dot11gCount" : 1,
        "dot11n2_4AuthCount" : 1,
        "dot11n2_4Count" : 1,
        "dot11n5AuthCount" : 1,
        "dot11n5Count" : 1,
        "key" : "String value",
        "subkey" : "String value",
        "type" : "DEVICE",
        "wgbAuthCount" : 1,
        "wgbCount" : 1,
        "wired100MAuthCount" : 1,
        "wired100MCount" : 1,
        "wired10MAuthCount" : 1,
        "wired10MCount" : 1,
        "wired1GAuthCount" : 1,
        "wired1GCount" : 1
      }
    }
  }
}