Search browsed OPC-UA nodes
GET/opc-ua/nodes
Searches the browsed nodes of one OPC-UA server matching the supplied filter criteria (name, node id, browse name, retrieval method, active, retrieval interval, asset path, signal path, value, parent object).
Without nodeClass the result is a page of object nodes with their matching variable nodes nested as children, and totalItems counts objects. With nodeClass it is a flat page of nodes of that class alone, and totalItems counts rows. A client that paginates has to read totalItems accordingly.
serverId is required: a node id is unique only per server, so without it the answer mixes the nodes of every server of the tenant - which is an answer no caller can use.
Answered with 400 rather than an empty page when the request cannot be understood: a missing or unparsable opcUaServerId, a retrievalMethod other than PULL or PUSH, a size outside 1..1000, or a sortFields naming a field the node list does not have. Every other filter narrows the result and never fails - a value nothing matches is an empty page, not an error.
Request
Responses
- 200
- 400
- 401
- 403
- default
One page of browsed nodes matching the filter. totalItems counts what the page is cut from, which depends on the shape: objects without nodeClass (each carrying its matching variables in children), rows with it. currentPage echoes the page asked for.
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