kapua
kapua copied to clipboard
✨ [REST-API] Add support to query operations by `status` in `GET /{scopeId}/devices/{deviceId}/operations`
Description
This PR implements the capability to search operations by their status using the GET /{scopeId}/devices/{deviceId}/operations
endpoint.
Changes Made
- New Feature: Added functionality to filter operations based on their status.
-
Refactor: Modified the
DeviceManagementOperations
query method:-
Deprecation: The current
query
method has been deprecated. It previously required the@PathParam("deviceId") EntityId deviceId
parameter. -
New Method: Introduced a new
query1
method that conforms to the parameters accepted and usage patterns of other query methods. ThedeviceId
parameter was removed, improving consistency across endpoints.
-
Deprecation: The current
-
Future Plans:
- The
_query
(deprecated) endpoint will be removed in a future release. - The
_query1
endpoint will eventually be deprecated in favor of a new_query
endpoint with the same behavior but a "correct" name. -
_query1
will be deleted in a subsequent release, following a smooth deprecation process.
- The
Impact
These changes are backward-compatible but introduce a new method for querying operations. Users relying on the existing query
method should migrate to the new query1
method or prepare for the upcoming changes.
Notes
- The naming of
query1
is provisional and can be adjusted based on feedback. It was chosen to maintain backward compatibility while moving towards a cleaner design. - Documentation have been updated to reflect these changes.