Cisco Cisco Configuration Engine 3.5 Entwickleranleitung

Seite von 344
6-28
Cisco Configuration Engine Software Development Kit API Reference and Programmer Guide 3.5
OL-17661-02
Chapter 6      Namespace Administration, Group Administration, and Notification APIs
Group Administration API
Clone Groups
This operation copies the group members from the source group into the destination group, without any 
device member. Note that deep copy is used when copying a group object; all descendant groups are 
replicated and copied as well.
Rename Group
This operation renames an existing group to a new name.
Method
void cloneGroups (String srcAbsGroupId, String destAbsGroupId)
Input parameter
srcAbsGroupId
This is the absolute group ID of the source group.
destAbsGroupId
This is the absolute group ID of the destination group.
Return
None.
Exceptions
This method could throw one of the following exceptions:
  •
DatastoreAccessException – Data-store connection problem or problem 
not described below.
  •
OperationTimeoutException – The current operation is not able to 
acquire a file lock within the time limit (for synchronizing data-store 
access), because other administration operation is currently in process.
  •
InvalidInputException 
  –
See 
 for basic rules.
  –
srcAbsGroupId and destAbsGroupId cannot be the same.
  •
InvalidMemberException 
  –
See 
 for basic rules.
  –
The sub-group member and its descendent groups to be copied cannot 
result into an absolute group ID that violates the absolute-group-ID 
string-length restriction.
  •
ParentNotFoundException – Cannot locate group specified by 
absSrcGroupId or destSrcGroupId.
  •
MemberAlreadyExistsException – Sub-group member or device member 
already existed in destAbsGroupId.
  •
MessageFormatException – Problem with message syntax.
Additional exception that could be thrown by the remote API:
CommunicationException – General server access problem.
Method
void renameGroup (String absGroupId, String newGroupId)
Input parameter