Interface InventoryApi

All Known Implementing Classes:
InventoryApiImpl

public interface InventoryApi
API for creating, and retrieving managed objects resources from the platform. Delete and update functionality is implemented on the returned managed object.
  • Method Details

    • get

      Returns the Managed Object of the Resource.
      Parameters:
      id - Managed Object General Identifier
      Returns:
      ManagedObjectRepresentation
      Throws:
      SDKException - if query failed
    • get

      Returns the Managed Object of the Resource. Using additional query params e.g. withChildren=false to optimize access time.
      Parameters:
      id - Managed Object General Identifier
      params - query parameters
      Returns:
      ManagedObjectRepresentation
      Throws:
      SDKException - if query failed
    • delete

      void delete(GId id) throws SDKException
      Deletes the Managed Object from the Cumulocity Server.
      Parameters:
      id - Managed Object General Identifier
      Throws:
      SDKException - if the managed object could not be deleted
    • deleteCascade

      void deleteCascade(GId id) throws SDKException
      Deletes the Managed Object and all child devices and child assets recursively from the Cumulocity Server.
      Parameters:
      id - Managed Object General Identifier
      Throws:
      SDKException - if the managed object could not be deleted
    • update

      ManagedObjectRepresentation update(ManagedObjectRepresentation managedObjectRepresentation) throws SDKException
      This update the ManagedObject for the operationCollection. Cannot update the ID.
      Parameters:
      managedObjectRepresentation - managed object representation
      Returns:
      ManagedObjectRepresentation updated ManagedObject.
      Throws:
      SDKException - if the managed object could not be updated
    • updateBulk

      Updates multiple managed objects (at most 50) in the platform with a single request. Every managed object must have its id set.

      If the request fails for one of the managed objects, a BulkRequestException is thrown. Its failedIndex is the position of that managed object in the request.

      For the limits and the validation rules, see Update multiple managed objects at once in the API reference.

      Parameters:
      managedObjects - the managed objects to be updated
      Returns:
      the updated managed objects
      Throws:
      BulkRequestException - if the request failed for one of the managed objects
      SDKException - if the managed objects could not be updated
    • getManagedObjectApi

      ManagedObject getManagedObjectApi(GId gid) throws SDKException
      Gets managed object resource by id. To get the managed object representation you have to call get() on the returned resource.
      Parameters:
      gid - id of the managed object to search for
      Returns:
      the managed object resource associated with the given id
      Throws:
      SDKException - if the query failed
    • create

      Creates managed object in the platform. The id of the managed object must not be set, since it will be generated by the platform
      Parameters:
      managedObject - the managed object to be created
      Returns:
      the created managed object with the generated id
      Throws:
      SDKException - if the managed object could not be created
    • createBulk

      Creates multiple managed objects (at most 50) in the platform with a single request. The ids of the managed objects must not be set.

      If the request failed while writing, part of it may have been created. In this case fragmentType identifies the created managed objects. To complete the request without duplicates, look them up by this fragment type and send again only the managed objects that the lookup did not return. A failure without an error body, for example a gateway timeout, can also follow a partial write.

      For the limits, the validation rules, and the details of the recovery, see Create one or multiple managed objects in the API reference.

      Parameters:
      managedObjects - the managed objects to be created
      Returns:
      the created managed objects with their generated ids, in the order of the request
      Throws:
      BulkRequestException - if the request failed for one of the managed objects
      SDKException - if the managed objects could not be created
    • getManagedObjects

      ManagedObjectCollection getManagedObjects() throws SDKException
      Gets the all the managed object in the platform
      Returns:
      collection of managed objects with paging functionality
      Throws:
      SDKException - if the query failed
    • getManagedObjectsByFilter

      ManagedObjectCollection getManagedObjectsByFilter(InventoryFilter filter) throws SDKException
      Gets the managed objects from the platform based on specified filter. Query based on type and fragmentType is not supported.
      Parameters:
      filter - the filter criteria(s)
      Returns:
      collection of managed objects matched by the filter with paging functionality
      Throws:
      SDKException - if the query failed
      IllegalArgumentException - if both type and fragmentType are specified in the filter
    • countManagedObjectsByFilter

      Integer countManagedObjectsByFilter(InventoryFilter filter) throws SDKException
      Returns the count of managed objects from the platform based on specified filter.
      Parameters:
      filter - the filter criteria(s)
      Returns:
      count of managed objects matched by the filter
      Throws:
      SDKException - if the query failed
      IllegalArgumentException - if the filter is null
    • getSupportedMeasurements

      SupportedMeasurementsRepresentation getSupportedMeasurements(GId id) throws SDKException
      Returns supported measurements of the Managed Object specified by its id
      Parameters:
      id - id of the managed object to search for
      Returns:
      SupportedMeasurementsRepresentation
      Throws:
      SDKException - if managed object does not exists
    • getSupportedSeries

      SupportedSeriesRepresentation getSupportedSeries(GId id) throws SDKException
      Returns supported series of the Managed Object specified by its id
      Parameters:
      id - id of the managed object to search for
      Returns:
      SupportedSeriesRepresentation
      Throws:
      SDKException - if managed object does not exists
    • getManagedObjectsByListOfIds

      @Deprecated ManagedObjectCollection getManagedObjectsByListOfIds(List<GId> ids) throws SDKException
      Deprecated.
      Gets the managed objects from the platform based on the given ids
      Parameters:
      ids - the list of ids of the managed objects to search for
      Returns:
      collection of managed objects matched in order of the given ids
      Throws:
      SDKException - if the query failed
    • getManagedObject

      @Deprecated ManagedObject getManagedObject(GId gid) throws SDKException
      Deprecated.
      Gets managed object resource by id. To get the managed object representation you have to call get() on the returned resource.
      Parameters:
      gid - id of the managed object to search for
      Returns:
      the managed object resource associated with the given id
      Throws:
      SDKException - if the query failed