Do not use this resource. Replaced by /op/groups/sites.
This provides information about the location groups and its hierarchy of campus and buildings. Note that internally, Locations are type of "Group", and thus all children will be of the generic type "subGroup".
Resource URL
/webacs/api/v1/data/SitesSince : 1.2
Response Parameters
Type | Attribute Name | Description |
---|---|---|
int |
apCount |
The number of Access Points within the location. |
int |
clearedAlarms |
Number of cleared alarms registered against devices within this location. |
int |
clientCount |
Number of clients connected to the location. |
int |
criticalAlarms |
Number of critical alarms registered against devices within this location. |
int |
deviceCount |
Total number of devices (non-APs). |
long |
groupId |
The internal id of the location group. |
String |
groupName |
The name of the location group. |
int |
informationAlarms |
Number of information alarms registered against devices within this location. |
Float |
latitude |
Latitude of location. |
String |
locationAddress |
Address of location. |
Float |
longitude |
Longitude of location. |
int |
majorAlarms |
Number of major alarms registered against devices within this location. |
int |
minorAlarms |
Number of minor alarms registered against devices within this location. |
String |
name |
The hierarchical name of the location. |
String |
siteType |
The type of location: 1 Campus, 2 Building, 4 Floor Area, 5 Outdoor Area. |
int |
warningAlarms |
Number of warning alarms registered against devices within this location. |
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://szier-m8-106.cisco.com/webacs/api/v1/data/Sites/42
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <queryResponse rootUrl="https://szier-m8-106.cisco.com/webacs/api/v1/data" requestUrl="https://szier-m8-106.cisco.com/webacs/api/v1/data/Sites/42" responseType="getEntity"> <entity url="https://szier-m8-106.cisco.com/webacs/api/v1/data/Sites/15" type="Sites" dtoType="sitesDTO"> <sitesDTO id="15" displayName="String value"> <apCount>1</apCount> <clearedAlarms>1</clearedAlarms> <clientCount>1</clientCount> <criticalAlarms>1</criticalAlarms> <deviceCount>1</deviceCount> <groupId>2</groupId> <groupName>String value</groupName> <informationAlarms>1</informationAlarms> <latitude>15.0</latitude> <locationAddress>String value</locationAddress> <longitude>15.0</longitude> <majorAlarms>1</majorAlarms> <minorAlarms>1</minorAlarms> <name>String value</name> <siteType>String value</siteType> <warningAlarms>1</warningAlarms> </sitesDTO> </entity> </queryResponse>
Sample JSON Payload
https://szier-m8-106.cisco.com/webacs/api/v1/data/Sites/42.json
{ "queryResponse" : { "@rootUrl" : "https : \/\/szier-m8-106.cisco.com\/webacs\/api\/v1\/data", "@requestUrl" : "https : \/\/szier-m8-106.cisco.com\/webacs\/api\/v1\/data\/Sites\/42", "@responseType" : "getEntity", "entity" : { "@url" : "https : \/\/szier-m8-106.cisco.com\/webacs\/api\/v1\/data\/Sites\/15", "@type" : "Sites", "@dtoType" : "sitesDTO", "sitesDTO" : { "@id" : "15", "@displayName" : "String value", "apCount" : 1, "clearedAlarms" : 1, "clientCount" : 1, "criticalAlarms" : 1, "deviceCount" : 1, "groupId" : 2, "groupName" : "String value", "informationAlarms" : 1, "latitude" : 15, "locationAddress" : "String value", "longitude" : 15, "majorAlarms" : 1, "minorAlarms" : 1, "name" : "String value", "siteType" : "String value", "warningAlarms" : 1 } } } }