com.cumulocity.sdk.client.devicecontrol
Interface DeviceControlApi

All Known Implementing Classes:

DeviceControlApiImpl

public interface DeviceControlApi

API for creating, updating and retrieving operations from the platform.

Method Summary

OperationRepresentation	create(OperationRepresentation operation) Creates operation in the platform.
OperationRepresentation	getOperation(GId gid) Gets operation by id
PagedCollectionResource<OperationCollectionRepresentation>	getOperations() Gets the all the operation in the platform
PagedCollectionResource<OperationCollectionRepresentation>	getOperationsByFilter(OperationFilter filter) Gets the operations from the platform based on specified filter.
OperationRepresentation	update(OperationRepresentation operation) Updates operation in the platform.

Method Detail

getOperation

OperationRepresentation getOperation(GId gid)
                                     throws SDKException

Gets operation by id

Parameters:

gid - id of the operation to search for

Returns:

the operation with the given id

Throws:

SDKException - if the operation is not found or if the query failed

create

OperationRepresentation create(OperationRepresentation operation)
                               throws SDKException

Creates operation in the platform. The id of the operation must not be set, since it will be generated by the platform

Parameters:

operation - operation to be created

Returns:

the created operation with the generated id

Throws:

SDKException - if the operation could not be created

update

OperationRepresentation update(OperationRepresentation operation)
                               throws SDKException

Updates operation in the platform. The operation to be updated is identified by the id within the given operation.

Parameters:

operation - to be updated

Returns:

the updated operation

Throws:

SDKException - if the operation could not be updated

getOperations

PagedCollectionResource<OperationCollectionRepresentation> getOperations()
                                                                         throws SDKException

Gets the all the operation in the platform

Returns:

collection of operations with paging functionality

Throws:

SDKException - if the query failed

getOperationsByFilter

PagedCollectionResource<OperationCollectionRepresentation> getOperationsByFilter(OperationFilter filter)
                                                                                 throws SDKException

Gets the operations from the platform based on specified filter. Queris based on [status, deviceId, agentId] and [deviceId, agentId] are not supported. currently not supported.

Parameters:

filter - the filter criteria(s)

Returns:

collection of operations matched by the filter with paging functionality

Throws:

SDKException - if the query failed

IllegalArgumentException - in case of queries based on [status, deviceId, agentId] or [deviceId, agentId]