Cisco Cisco Security Manager 4.11 Guia De Especificação

Página de 217
 
 
 
  
 
Cisco Security Manager 4.4 API Specification (Version 1.1) 
 
OL- 29074-01 
Page  114
 
HTTP/XML Content 
Definition 
Element: deviceGroupPath 
An element that identifies the device group being requested. Contains 1 or more 
pathItem entries. All the pathItems combined (separated by a slash “/”) will be 
treated as one group name. The path information from the response of the 
GetGroupList method can be used here. Each group in the GetGroupList has 
path attribute which provide the complete path name. Each element in the path 
(separated by a “/”) is encoded as pathItems. For example if device details for 
group includes a path such as “/VmsVirtualRoot/San Jose/Building 13” 
(obtained from the response of getGroupList API), then pathItems will be 
“VmsVirtualRoot”, “San Jose” and “Building 13”. The “VmsVirtualRoot” is a 
virtual “root node” for all groups. 
HTTP Method 
POST 
HTTP Header: asCookie 
The cookie returned by the login method that identifies the authentication 
session 
Returns 
200 OK + XML 
 
401 Unauthorized 
 
 
 
Figure 66: DeviceListByGroupRequest XML Schema   
 
3.2.4.2 Response 
The GetDeviceListByGroup response and error codes are the same as method GetDeviceListByCapability response. 
 
<
xs:element
 name
="deviceListByGroupRequest"
 type
="DeviceListByGroupRequest"/> 
 
<
xs:complexType
 name
="DeviceListByGroupRequest"> 
 
 
<
xs:complexContent
 
 
 
<
xs:extension
 base
="BaseReqResp"> 
 
 
 
 
<
xs:sequence
 
 
 
 
 
<
xs:element
 name
="deviceGroupPath"
 type
="DeviceGroupPath"/> 
 
 
 
 
</
xs:sequence
 
 
 
</
xs:extension
 
 
</
xs:complexContent
 
</
xs:complexType