Since Product Version: 1.2
Resource Information
Rate Limiting? |
Yes |
Sorting? |
No |
Paging? |
No |
Filtering? |
No |
Aggregation? |
No |
Response Formats |
xml json |
User Group |
NBI Read |
HTTP Methods |
GET |
DevNet Discussions
Resource URL
/webacs/api/v1/op/statisticsService/application/worstNHostsRequest Parameters
Attribute | Source | Description |
---|---|---|
startTime Long |
query |
RequiredSpecifies the time to check the worst N hosts from. (See 'range' for more details) |
endTime Long |
query |
RequiredSpecifies the time to check the worst N hosts to. (See 'range' for more details) |
range Integer |
query |
RequiredSpecifies the range of time (in hours). This field can contain values like 1,2,4,8,16,24,168(1week),336(2Week),720(1Month),8760(1Year). Note: Either the range parameter or the parameters startTime and endTime are required. The range parameter overrides the startTime and endTime parameters. |
appId String |
query |
OptionalUse to filter on a specific application by ID. Defaults to 0 which implies no filtering. |
siteId Integer |
query |
OptionalUse to filter on a specific site by ID. Defaults to 0 which implies no filtering. |
domainId String |
query |
OptionalUse to filter on a specific domain by ID. Only used with siteId is zero. Defaults to ROOT-DOMAIN. |
pdsId String |
query |
OptionalUsed to filter on a specific PDS by ID. If non-zero siteId is expected to be non-zero. |
attribute String |
query |
OptionalThe attribute on which to measure worst N performing applications. Possible Values: transTime, svrRespTime, networkDelay. |
sortOrder String |
query |
OptionalThe sort order of the results (ASC/DESC). Defaults to DESC for worst hosts first. |
topN Integer |
query |
RequiredThe number of results to return. |
nwAwareValue String |
query |
OptionalUse to filter on a specific CONNECTIONTYPE. |
ssidValue String |
query |
OptionalUse to filter on a specifc SSID. |
userId String |
query |
OptionalUse to filter on a specifc USERID. |
macAddr String |
query |
OptionalUse to filter on a specifc MACADDR. |
Response Parameters
Attribute | Description |
---|---|
The set of nested StatisticsDTO objects. |
|
The set of statistics entries with attribute name, display name, and value triplets belonging to a single entity for the given category of statistics. |
|
statisticsName StatisticsOperationTypeEnum |
The Statistics operation type. Allowed values: |
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 Response Payload
https://localhost/webacs/api/v1/op/statisticsService/application/worstNHosts?range=1&topN=5&attribute=networkDelay
<?xml version="1.0" ?>
<mgmtResponse responseType="operation" requestUrl="https://localhost/webacs/api/v1/op/statisticsService/application/worstNHosts?range=1&amp;topN=5&amp;attribute=networkDelay
" rootUrl="https://localhost/webacs/api/v1/op">
<statisticsDTO>
<childStatistics>
<childStatistic>
<childStatistics>
<childStatistic>
<childStatistics>
<childStatistic>
<childStatistics>
<childStatistic>
<statisticEntries>
<statisticEntry>
<attributeName>String value</attributeName>
<displayName>String value</displayName>
<entryValue>String value</entryValue>
</statisticEntry>
</statisticEntries>
<statisticsName>DEVICE_TOPN_CPU_UTILIZATION</statisticsName>
</childStatistic>
</childStatistics>
<statisticEntries>
<statisticEntry>
<attributeName>String value</attributeName>
<displayName>String value</displayName>
<entryValue>String value</entryValue>
</statisticEntry>
</statisticEntries>
<statisticsName>DEVICE_TOPN_CPU_UTILIZATION</statisticsName>
</childStatistic>
</childStatistics>
<statisticEntries>
<statisticEntry>
<attributeName>String value</attributeName>
<displayName>String value</displayName>
<entryValue>String value</entryValue>
</statisticEntry>
</statisticEntries>
<statisticsName>DEVICE_TOPN_CPU_UTILIZATION</statisticsName>
</childStatistic>
</childStatistics>
<statisticEntries>
<statisticEntry>
<attributeName>String value</attributeName>
<displayName>String value</displayName>
<entryValue>String value</entryValue>
</statisticEntry>
</statisticEntries>
<statisticsName>DEVICE_TOPN_CPU_UTILIZATION</statisticsName>
</childStatistic>
</childStatistics>
<statisticEntries>
<statisticEntry>
<attributeName>String value</attributeName>
<displayName>String value</displayName>
<entryValue>String value</entryValue>
</statisticEntry>
</statisticEntries>
<statisticsName>DEVICE_TOPN_CPU_UTILIZATION</statisticsName>
</statisticsDTO>
</mgmtResponse>
Sample JSON Response Payload
https://localhost/webacs/api/v1/op/statisticsService/application/worstNHosts.json?range=1&topN=5&attribute=networkDelay
{
"mgmtResponse" : {
"@responseType" : "operation",
"@requestUrl" : "https : \/\/localhost\/webacs\/api\/v1\/op\/statisticsService\/application\/worstNHosts?range=1&topN=5&attribute=networkDelay\n\t\t\t\t\t",
"@rootUrl" : "https : \/\/localhost\/webacs\/api\/v1\/op",
"statisticsDTO" : {
"childStatistics" : {
"childStatistic" : {
"childStatistics" : {
"childStatistic" : {
"childStatistics" : {
"childStatistic" : {
"childStatistics" : {
"childStatistic" : {
"statisticEntries" : {
"statisticEntry" : {
"attributeName" : "String value",
"displayName" : "String value",
"entryValue" : "String value"
}
},
"statisticsName" : "DEVICE_TOPN_CPU_UTILIZATION"
}
},
"statisticEntries" : {
"statisticEntry" : {
"attributeName" : "String value",
"displayName" : "String value",
"entryValue" : "String value"
}
},
"statisticsName" : "DEVICE_TOPN_CPU_UTILIZATION"
}
},
"statisticEntries" : {
"statisticEntry" : {
"attributeName" : "String value",
"displayName" : "String value",
"entryValue" : "String value"
}
},
"statisticsName" : "DEVICE_TOPN_CPU_UTILIZATION"
}
},
"statisticEntries" : {
"statisticEntry" : {
"attributeName" : "String value",
"displayName" : "String value",
"entryValue" : "String value"
}
},
"statisticsName" : "DEVICE_TOPN_CPU_UTILIZATION"
}
},
"statisticEntries" : {
"statisticEntry" : {
"attributeName" : "String value",
"displayName" : "String value",
"entryValue" : "String value"
}
},
"statisticsName" : "DEVICE_TOPN_CPU_UTILIZATION"
}
}
}