Top N Clients

GET {{base_url}}/monitoring/v1/clients/bandwidth_usage/topn?group=<string>&swarm_id=<string>&label=<string>&network=<string>&cluster_id=<string>&stack_id=<string>&count=<integer>&from_timestamp=<integer>&to_timestamp=<integer>

Get top N client details over a time period. You can only specify one of group, swarmid, label, clusterid and stackid parameters. Possible errorcodes for the error responses are 1. 0001 - General Error. 2. 0002 - Validation Error. Out of Range value for a query parameter. 3. 0003 - Validation Error. Unsupported query combination

Request Params

KeyDatatypeRequiredDescription
groupstringFilter by group name
swarm_idstringFilter by Swarm ID. Field supported for AP clients only
labelstringFilter by Label name
networkstringFilter by network name. Field supported for wireless clients only
cluster_idstringFilter by Mobility Controller serial number
stack_idstringFilter by Switch stack_id
countstringRequired top N clients count. Default is 5 and maximum is 100
from_timestampstringNeed information from this timestamp. Timestamp is epoch in seconds. Default is current timestamp minus 3 hours
to_timestampstringNeed information to this timestamp. Timestamp is epoch in seconds. Default is current timestamp

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;clients&quot;:[{&quot;macaddr&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;rx_data_bytes&quot;:&quot;\u003cnumber\u003e&quot;,&quot;tx_data_bytes&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;macaddr&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;rx_data_bytes&quot;:&quot;\u003cnumber\u003e&quot;,&quot;tx_data_bytes&quot;:&quot;\u003cnumber\u003e&quot;}],&quot;count&quot;:&quot;\u003cinteger\u003e&quot;}