Cisco Cisco Security Manager 4.0 仕様ガイド

ページ / 217
 
 
 
  
 
Cisco Security Manager 4.4 API Specification (Version 1.1) 
 
OL- 29074-01 
Page  129
 
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.  
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. 
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. 
 
Figure 81: Method GetPolicyConfigByDeviceGID Request Example  
Table 70: 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 
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> 
 
<protVersion>1.0</protVersion> 
 
<reqId>123</reqId> 
 
<gid>00000000-0000-0000-0000-004294967927</gid> 
 
<policyType>DeviceAccessRuleFirewallPolicy</policyType> 
</policyConfigByDeviceGIDRequest>