Cisco Cisco Security Manager 4.4 Guia De Especificaciones
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.
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.
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:
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>
<csm:deviceCapability>*</csm:deviceCapability>
HTTP Method
POST
HTTP Header: asCookie
The cookie returned by the login method that identifies the authentication
session
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>
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>