Since Product Version: 1.2
Resource URL
/webacs/api/v1/op/statisticsService/interface/availabilityRequest Parameters
Type | Attribute Name | Source | Description |
---|---|---|---|
Long |
startTime required |
query |
Specifies the start time in seconds to check the device availability from. (See 'range' for more details) |
Long |
endTime required |
query |
Specifies the end time in seconds to check the device availability to. (See 'range' for more details) |
Integer |
range required |
query |
Specifies 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. |
String |
ipAddress required |
query |
The IP address of the device to check the interface availability of. |
String |
ifName required |
query |
The interface name to check availability of. |
Response Parameters
Type | Attribute Name | Description |
---|---|---|
childStatistics |
The set of nested StatisticsDTO objects. |
|
statisticEntry |
The set of statistics entries with attribute name, display name, and value triplets belonging to a single entity for the given category of statistics. |
|
StatisticsOperationTypeEnum |
statisticsName |
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://172.25.123.114/webacs/api/v1/op/statisticsService/interface/availability?range=1&ipAddress="192.168.0.1"&ifName="eth0"
<?xml version="1.0" ?> <mgmtResponse responseType="operation" requestUrl="https://172.25.123.114/webacs/api/v1/op/statisticsService/interface/availability?range=1&amp;ipAddress=&quot;192.168.0.1&quot;&amp;ifName=&quot;eth0&quot; " rootUrl="https://172.25.123.114/webacs/api/v1/op/"> <statisticsDTO> <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> </statisticsDTO> </mgmtResponse>
Sample JSON Response Payload
https://172.25.123.114/webacs/api/v1/op/statisticsService/interface/availability.json?range=1&ipAddress="192.168.0.1"&ifName="eth0"
{ "mgmtResponse" : { "@responseType" : "operation", "@requestUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/op\/statisticsService\/interface\/availability?range=1&ipAddress="192.168.0.1"&ifName="eth0"\n\t\t\t\t\t", "@rootUrl" : "https : \/\/172.25.123.114\/webacs\/api\/v1\/op\/", "statisticsDTO" : { "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" } } }