Cisco Cisco Configuration Engine 3.5 Entwickleranleitung

6-26

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

Figure 6-4

Example of Clone Operation: (a) Before Clone (b) After Clone

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

Table 6-2

for basic rules.

–

srcAbsGroupId and destAbsGroupId cannot be the same.

•

InvalidMemberException

–

See

Table 6-2

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
srcAbsGroupId or destAbsGroupId.

•

MemberNotFoundException – Member not found in group
srcAbsGroupId.

•

MemberAlreadyExistsException – Sub-group member or device member
already existed in destAbsGroupId.

•

MessageFormatException – Problem with message syntax.

Additional exception could be thrown by remote API:

CommunicationException – General server access problem.

(a)

(b)