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  106
 
3.2.2 Method GetGroupList 
The GetGroupList method returns the list of devices matching a particular type or all devices if the wildcard 
argument is chosen. 
3.2.2.1 Request 
An example of the method GetGroupList request is shown in the figure below..  The fields in these messages are 
described in the table below. 
 
Figure 57: Method GetGroupList Request Example  
Table 53: Method GetGroupList Request URL Argument Descriptions 
HTTP/XML Content 
Definition 
GroupListRequest 
Group list request that contains request arguments 
Element: 
includeEmptyGroups 
An element that identifies whether the response should include groups that have 
no devices within them or not. 
HTTP Method 
POST 
HTTP Header: asCookie 
The cookie returned by the login method that identifies the authentication 
session 
Returns 
200 OK + XML 
 
401 Unauthorized 
 
 
URL: 
 
https://hostname/nbi/configservice/getGroupList 
 
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”?> 
<groupListRequest> 
 
<protVersion>1.0</protVersion> 
 
<reqId>123</reqId> 
 
<includeEmptyGroups>false</includeEmptyGroups> 
</groupListRequest>