Cisco Cisco Security Manager 4.5 Guia De Especificação

Página de 217
 
 
 
  
 
Cisco Security Manager 4.4 API Specification (Version 1.1) 
 
OL- 29074-01 
Page  113
 
 
3.2.4 Method GetDeviceListByGroup 
The GetDeviceListByGroup method returns the list of devices contained within a particular group or all devices if 
the wildcard argument is chosen. The group name path will be prepared by combining the entire path Items 
mentioned in the request body. The list of devices will be from the combination of the path Items. For example, the 
path Item is provided as San Jose alone and the CSM Server has sub groups under San Jose then the API will return 
all the devices matching group San Jose and other sub groups under it as well. 
For example if the path items are San Jose and Building 14 then the devices matching group path “/San 
Jose/Building 1
4” and its sub group (if any) will be returned. 
 
3.2.4.1 Request 
An example of the method GetDeviceListByGroup request is shown in the figure below.  The fields in these 
messages are described in the table below. 
 
Figure 65: Method GetDeviceListByGroup Request Example  
Table 58: Method GetDeviceListByGroup Request URL Argument Descriptions 
HTTP/XML Content 
Definition 
getDeviceListByGroupRequest 
Device list request that returns a list of devices contained in the group 
URL: 
 
https://hostname/nbi/configservice/getDeviceListByGroup 
 
HTTP Header: 
 
Set-Cookie: asCookie=732423sdfs73242; expires=Fri, 31-Dec-2010 23:59:59 GMT; path=/; 
domain=.hostdomain.com  
 
XML Argument: 
 
<?xml version=”1.0” encoding=”UTF-8”?> 
<deviceListByGroupRequest> 
 
<protVersion>1.0</protVersion> 
 
<reqId>123</reqId> 
 
<deviceGroupPath> 
 
  <pathItem>building10</pathItem> 
 
  <pathItem>4
th
 floor</pathItem> 
 
</deviceGroupPath> 
</deviceListByGroupRequest>