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 or no asset at all, 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