Cisco Cisco Prime Collaboration Provisioning 11.1 User Guide

Page 23 of 2

updateDevice Java Signature

Updates a device.

Syntax:

public ResponseReturn updateDevice (CUPMServiceStub stub, DeviceValue device, String endPointReference,

String idPrefix);

Parameters:

• device— Device object with attribute keys and attribute name-value pairs set to their initial value.

• endPointReference—String to convert to an EndpointReference object that the asynchronous result

notification will be sent to.

• idPrefix—String that is added to the beginning of the internally generated numeric to form the NBI ID. A

null or empty string is valid, resulting in an NBI identifier that is just the internally generated numeric.

Returns:

CupmApiResponseValue—Object with NBI ID.

Throws:

UpdateDeviceException—If server cannot execute NBI request.

ASyncReturn:

• CupmApiResultValue—Contains CupmApiStatus only.

• CupmApiFaultType—Included if the NBI request fails.

Note: To remove a capability from a device, specify the capability in the device object and set the capabilityAction
attribute to REMOVE. Note that the last capability assigned to a device cannot be removed.

listDevice Java Signature

Selects a set of devices.

Syntax:

public ResponseReturn listDevice (CUPMServiceStub stub, CupmApiFilterValue filter, String endPointReference,

String idPrefix);

Parameters:

• filter—Defines the object selection criteria and the device object attributes to be returned. If you only enter

the version, an error is returned. A version-based query is dependent on capabilityName, so you must

also enter capabilityName.

You can filter using the following attributes:

DBPort

ExtensionMobilityServiceName