Cisco Cisco Security Manager 4.11 Guía Del Usuario
Cisco Security Manager 4.11 API Specification (Version 2.3)
Page 133
3.2.9 Method GetPolicyConfigByDeviceGID
The GetPolicyConfigByDeviceGID method returns a specific policy and its associated policy objects based on the
device id and policy type passed into the method. Access to this API requires a view_policy privilege on the policy
being queried and also a view_device privilege on the device for which this policy is being fetched.
device id and policy type passed into the method. Access to this API requires a view_policy privilege on the policy
being queried and also a view_device privilege on the device for which this policy is being fetched.
This method returns the applicable policy on a device (irrespective of whether it is local or shared). Thus this is
often the most convienient method to read supported policy configuration of a device.
often the most convienient method to read supported policy configuration of a device.
3.2.9.1 Request
An example of the method GetPolicyConfigByDeviceGID 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 82: Method GetPolicyConfigByDeviceGID Request Example
Table 71: Method GetPolicyConfigByDeviceGID Request URL Attribute Descriptions
Method Details
Definition
policyConfigByDeviceByGIDRequest
A global ID request and same attributes as previously defined
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/getPolicyConfigById
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”?>
<policyConfigByDeviceGIDRequest>
https://hostname/nbi/configservice/getPolicyConfigById
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”?>
<policyConfigByDeviceGIDRequest>
<protVersion>1.0</protVersion>
<reqId>123</reqId>
<gid>00000000-0000-0000-0000-004294967927</gid>
<policyType>DeviceAccessRuleFirewallPolicy</policyType>
</policyConfigByDeviceGIDRequest>