Cisco Prime Infrastructure API
Prime Infrastructure API Documentation

GET HistoricalClientTraffics

Represents client traffic information collected in last 24 hours with 15 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 be resulted in longer running query to affect system performance.

Since Product Version: 1.2

Resource Information

Rate Limiting?

Yes

Sorting?

Yes

Paging?

Yes

Filtering?

Yes

Group Filtering?

No

Aggregation?

No

Response Formats

xml

json

User Group

NBI Read

HTTP Methods

GET

API version v1 is deprecated

This API version has been deprecated. It will be removed in a future release of the product. Please develop new clients using the latest API version. Please modify your existing clients to use a later API version.

Resource URL

/webacs/api/v1/data/HistoricalClientTraffics

Deprecated

This version has been deprecated. Please use v4.

Response Parameters

Attribute Description

collectionTime long

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

dot11aReceived String

Total bytes received using 802.11a protocol

dot11aSent long

Total bytes sent using 802.11a protocol

dot11aThroughput long

Total throughput in Kbps using 802.11a protocol

dot11acReceived long

Total bytes received using 802.11ac protocol

dot11acSent long

Total bytes sent using 802.11ac protocol

dot11acThroughput long

Total throughput in Kbps using 802.11ac protocol

dot11bReceived String

Total bytes received using 802.11b protocol

dot11bSent long

Total bytes sent using 802.11b protocol

dot11bThroughput long

Total throughput in Kbps using 802.11b protocol

dot11gReceived String

Total bytes received using 802.11g protocol

dot11gSent long

Total bytes sent using 802.11g protocol

dot11gThroughput long

Total throughput in Kbps using 802.11g protocol

dot11n2_4Received String

Total bytes received using 802.11n protocol in 2.4GHz band

dot11n2_4Sent long

Total bytes sent using 802.11n protocol in 2.4GHz band

dot11n2_4Throughput long

Total throughput in Kbps using 802.11n protocol in 2.4GHz band

dot11n5Received String

Total bytes received using 802.11n protocol in 5GHz band

dot11n5Sent long

Total bytes sent using 802.11n protocol in 5GHz band

dot11n5Throughput long

Total throughput in Kbps using 802.11n protocol in 5GHz band

instanceOrigin InstanceOriginEnum

Allowed values:

  • UNCONCERNED
  • APPLICATION
  • NETWORK

instanceTenantId Integer

This is a tenant id for this instance.

key String

key represents the element

received String

Total bytes received

sent long

Total bytes sent

subkey String

subkey is used to further categorize client count

throughput long

Total throughput in Kbps

type ClientCountTypeEnum

Type of count element

Allowed values:

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

wired100MReceived String

Total bytes sent from wired clients connected to wired switch on 100Mbps port

wired100MSent long

Total bytes send from wired clients connected to wired switch on 100Mbps port

wired100MThroughput long

Total throughput from wired clients connected to wired switch on 100Mbps port

wired10MReceived String

Total bytes sent from wired clients connected to wired switch on 10Mbps port

wired10MSent long

Total bytes send from wired clients connected to wired switch on 10Mbps port

wired10MThroughput long

Total throughput from wired clients connected to wired switch on 10Mbps port

wired1GReceived String

Total bytes sent from wired clients connected to wired switch on 1Gbps port

wired1GSent long

Total bytes send from wired clients connected to wired switch on 1Gbps port

wired1GThroughput long

Total throughput from 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://localhost/webacs/api/v1/data/HistoricalClientTraffics/15

<?xml version="1.0" ?>
<queryResponse type="HistoricalClientTraffics" responseType="getEntity" requestUrl="https://localhost/webacs/api/v1/data/HistoricalClientTraffics/15" rootUrl="https://localhost/webacs/api/v1/data">
  <entity dtoType="historicalClientTrafficsDTO" type="HistoricalClientTraffics" url="https://localhost/webacs/api/v1/data/HistoricalClientTraffics/15">
    <historicalClientTrafficsDTO displayName="String value" id="15" instanceTenantId="String value" uuid="String value">
      <collectionTime>2</collectionTime>
      <dot11aSent>2</dot11aSent>
      <dot11aThroughput>2</dot11aThroughput>
      <dot11acReceived>2</dot11acReceived>
      <dot11acSent>2</dot11acSent>
      <dot11acThroughput>2</dot11acThroughput>
      <dot11bSent>2</dot11bSent>
      <dot11bThroughput>2</dot11bThroughput>
      <dot11gSent>2</dot11gSent>
      <dot11gThroughput>2</dot11gThroughput>
      <dot11n2_4Sent>2</dot11n2_4Sent>
      <dot11n2_4Throughput>2</dot11n2_4Throughput>
      <dot11n5Sent>2</dot11n5Sent>
      <dot11n5Throughput>2</dot11n5Throughput>
      <key>String value</key>
      <sent>2</sent>
      <subkey>String value</subkey>
      <throughput>2</throughput>
      <type>DEVICE</type>
      <wired100MSent>2</wired100MSent>
      <wired100MThroughput>2</wired100MThroughput>
      <wired10MSent>2</wired10MSent>
      <wired10MThroughput>2</wired10MThroughput>
      <wired1GSent>2</wired1GSent>
      <wired1GThroughput>2</wired1GThroughput>
      <dot11aReceived>String value</dot11aReceived>
      <dot11bReceived>String value</dot11bReceived>
      <dot11gReceived>String value</dot11gReceived>
      <dot11n2_4Received>String value</dot11n2_4Received>
      <dot11n5Received>String value</dot11n5Received>
      <received>String value</received>
      <wired100MReceived>String value</wired100MReceived>
      <wired10MReceived>String value</wired10MReceived>
      <wired1GReceived>String value</wired1GReceived>
    </historicalClientTrafficsDTO>
  </entity>
</queryResponse>

Sample JSON Payload

https://localhost/webacs/api/v1/data/HistoricalClientTraffics/15.json

{
  "queryResponse" : {
    "@type" : "HistoricalClientTraffics",
    "@responseType" : "getEntity",
    "@requestUrl" : "https : \/\/localhost\/webacs\/api\/v1\/data\/HistoricalClientTraffics\/15",
    "@rootUrl" : "https : \/\/localhost\/webacs\/api\/v1\/data",
    "entity" : {
      "@dtoType" : "historicalClientTrafficsDTO",
      "@type" : "HistoricalClientTraffics",
      "@url" : "https : \/\/localhost\/webacs\/api\/v1\/data\/HistoricalClientTraffics\/15",
      "historicalClientTrafficsDTO" : {
        "@displayName" : "String value",
        "@id" : "15",
        "@instanceTenantId" : "String value",
        "@uuid" : "String value",
        "collectionTime" : 2,
        "dot11aSent" : 2,
        "dot11aThroughput" : 2,
        "dot11acReceived" : 2,
        "dot11acSent" : 2,
        "dot11acThroughput" : 2,
        "dot11bSent" : 2,
        "dot11bThroughput" : 2,
        "dot11gSent" : 2,
        "dot11gThroughput" : 2,
        "dot11n2_4Sent" : 2,
        "dot11n2_4Throughput" : 2,
        "dot11n5Sent" : 2,
        "dot11n5Throughput" : 2,
        "key" : "String value",
        "sent" : 2,
        "subkey" : "String value",
        "throughput" : 2,
        "type" : "DEVICE",
        "wired100MSent" : 2,
        "wired100MThroughput" : 2,
        "wired10MSent" : 2,
        "wired10MThroughput" : 2,
        "wired1GSent" : 2,
        "wired1GThroughput" : 2,
        "dot11aReceived" : "String value",
        "dot11bReceived" : "String value",
        "dot11gReceived" : "String value",
        "dot11n2_4Received" : "String value",
        "dot11n5Received" : "String value",
        "received" : "String value",
        "wired100MReceived" : "String value",
        "wired10MReceived" : "String value",
        "wired1GReceived" : "String value"
      }
    }
  }
}