Get Clients Usage

get

https://de1.api.central.arubanetworks.com/network-monitoring/v1/clients-usage

Retrieves the TX and RX usage trend (sum of bytes) for clients over a time range. Supports filtering through the filter query parameter using timestamp, macAddress, serialNumber, siteId, and siteName. When macAddress is provided, returns usage trend for that specific client. When serialNumber is provided, returns aggregated usage for all clients on that device. When siteId or siteName is provided, returns aggregated usage for all clients at that site. When no filter is provided, returns tenant-level aggregated usage.

Sampling interval is determined by the time range:

≤ 1 day → 5 min
1 day and ≤ 1 month → 3 hours

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

filter

string

length ≤ 256

OData Version 4.0 filter string (limited functionality). Supports only 'and' conjunction ('or' and 'not' are NOT supported). Supported fields, operators and value format are in the below given table.

Field	Operators	Format
`timestamp`	`gt` and `lt`	Date-time (RFC 3339 timestamp in UTC+0) string
`siteId`	`eq`	string
`siteName`	`eq`	string
`macAddress`	`eq`	string
`serialNumber`	`eq`	string

The operators are implemented as follows:

gt: Used to indicate the start of the timestamp range. If timestamp gt is omitted, it defaults to 3 hours before the timestamp lt value. If both timestamp gt and timestamp lt are omitted, the effective start defaults to 3 hours before the current timestamp.
lt: Used to indicate the end of the timestamp range. If timestamp lt is omitted, it defaults to the current timestamp.
For global-level queries, the interval between timestamp gt and timestamp lt must be less than or equal to 7 days. For site-level queries, the interval must be less than or equal to 1 month.
eq: Only values exactly matching the given value are returned.

Responses

200Response schema for clients usage trend.

400Bad Request

401Unauthorized request.

403Forbidden: Access is denied.

404Not Found error

429Too Many Requests. Rate limit exceeded.

500Internal server error.