Cisco Cisco Configuration Engine 3.5 Entwickleranleitung
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.
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.
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.
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.
result into an absolute group ID that violates the absolute-group-ID
string-length restriction.
•
ParentNotFoundException – Cannot locate group specified by
absSrcGroupId or destSrcGroupId.
absSrcGroupId or destSrcGroupId.
•
MemberAlreadyExistsException – Sub-group member or device member
already existed in destAbsGroupId.
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