Returns a page of alarms
GET/alarming
Returns one page of the alarm results, filtered and sorted by the server. The alarm table grows without bound - every sweep of the condition monitoring appends to it - so there is deliberately no way to ask for all of it: the size of the answer depends on the requested page size and not on the size of the table. Because of that, the counts a client shows cannot be derived from the returned items any more and travel with the page instead: totalItems is how many alarms match the filter, totalUnfilteredItems how many exist at all, and severityCounts how the matching ones are spread across the severities. All three are computed from the filtered query, not from the page. A request that names no sort is answered sorted by triggeredAt descending - the alarm raised last comes first - so the same request always returns the same page in the same order. The two sort parameters fall back to that default independently, and the alarm id is appended to whatever sort applies, because a page out of a result whose order is not unique may show one alarm twice and another never.
Request
Responses
- 200
- 400
- 401
- 403
- default
One page of the matching alarms, with the counts of the whole result
the default error response
Unauthorized — the bearer token is missing, expired or invalid, or carries no role. Errors raised by the security aspects contain an ErrorDto body; requests rejected by the security filter chain may have an empty body.
Forbidden — the authenticated user lacks the required role or access rights.
the default error response