Cisco Unity Connection Provisioning Interface (CUPI) API -- Alternate Names
About Alternate Names
This page contains information on how to use the API to create, list, update, and delete Alternate Names. Alternate Names are shared by users, contacts, distribution lists, private lists, and VPIM locations. Each of these objects can have Alternate Names associated with them.
Listing and Viewing
The following is an example of a GET that lists all Alternate Names:
|
The following is the response from the above GET request:
|
In this example, the first Alternate Name in the list belongs to a user as denoted by the GlobalUserObjectId field. The second Alternate Name belongs to a Distribution List, and so on.
For Distribution Lists, Private Lists, and VPIM Locations, only the FirstName field is used to provide the Alternate Name. These objects only have a single Display Name, they do not have separate first and last names.
To retrieve a sorted list of all Alternate Names, add the following query parameter:
|
For example, to retrieve a list of all Alternate Names sorted by Object Id in ascending order:
|
To retrieve a specific Alternate Name by its object ID:
|
Searching
To retrieve a list of Alternate Names that meet a specified search criteria, add the following query parameter to a GET:
|
For example, to find all Alternate Names with a GlobalUserObjectId that equals "bde24d71-95fa-4ba8-bf1b-0e19a4e9a68b" (this is a search to find all Alternate Names for a specific User):
|
To find Alternate Names for various objects, use the following object id columns:
- For Users, use GlobalUserObjectId.
- For Contacts, use ContactObjectId.
- For Distribution Lists, use DistributionListObjectId.
- For Private Lists, use PersonalGroupObjectId.
- For VPIM Locations, use LocationObjectId.
Creating
The required fields for creating an Alternate Name are a parent object id, a First Name, and for some objects a Last Name. To determine what parent object id column to use to create the new Alternate Name, use the list found in the Searching section above. For example, if you are creating an Alternate Name for a User, then a GlobalUserObjectId needs to be provided.
The following is an example of a POST that creates an Alternate Name for a User with a First Name of "Mike" and a Last Name of "Wholebert" whose Global User Object Id is "bde24d71-95fa-4ba8-bf1b-0e19a4e9a68b":
|
When creating Distribution Lists, Private Lists, or VPIM Locations, only the FirstName field is used to provide the Alternate Name
Updating
The following is an example of a PUT request that modifies the First Name and Last Name of an existing Alternate Name:
|
Deleting
The following is an example of a DELETE request that deletes an Alternate Name:
|