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  110
 
3.2.3 Method GetDeviceListByCapability 
The GetDeviceListByCapability method returns the list of devices matching one or more categories or all devices if 
the wildcard argument is chosen. 
3.2.3.1 Request 
An example of the method GetDeviceListByType request is shown in the figure below..  The fields in these 
messages are described in the table below. 
 
Figure 61: Method GetDeviceListByCapability Request Example  
Table 56: Method GetDeviceListByCapability Request URL Argument Descriptions 
HTTP/XML Content 
Definition 
getDeviceListByCapabilityRequest  Device list request that contains request arguments 
Element: deviceCapability 
One or more instances of an element that identifies the capability of the device 
being requested. Allowed values include: 
 
firewall: To return all ASA, PIX and FWSM devices. 
 
ids: To return all IPS Devices 
 
router: To return routers 
 
switch: To return switches 
Wildcard may be specified as 
<csm:deviceCapability>*</csm:deviceCapability> 
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/getDeviceListByType 
 
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”?> 
<deviceListByCapabilityRequest> 
 
<protVersion>1.0</protVersion> 
 
<reqId>123</reqId> 
 
<deviceCapability>firewall</deviceCapability> 
</deviceListByCapabilityRequest>