Actions41
- Alarm Actions
- Alarm Category Actions
- Data Collection Actions
- Event Template Actions
- Find Actions
- Object Actions
- Scheduled Task Actions
- Server Actions
- User Actions
Object → Search
AI-generatedSummary
Search NetXMS objects by name, IP address, class, parent, or zone by POSTing the criteria to /v1/objects/search. Returns the matching objects from the server.
Inputs
- Search Criteria > Name — Substring match against object name or alias. Omitted from the request if empty.
- Search Criteria > IP Address — Filter by primary IP address.
- Search Criteria > Object Class — Multi-select of classes (Node, Container, Interface, Subnet, Zone, Cluster, Sensor, Template, etc.). Sent as an array only if at least one is selected.
- Search Criteria > Parent Object ID — Restrict results to direct or indirect children of this object ID. 0 is treated as unset and not sent.
- Search Criteria > Zone UIN — Filter by zone UIN. 0 is treated as unset and not sent.
Output shape
Objects returned by the NetXMS search endpoint, emitted as n8n items (an array response becomes one item per element). The exact object fields come from the server and are not defined in the node.
All criteria are optional. With none set, an empty body is sent, so results depend on the server's behavior. Each input item triggers one search. On error, the node throws, or emits an item with an error message if Continue On Fail is enabled. The node logs in to NetXMS with the credential's username and password on each execution.
Examples
Example 1: Find all Node objects whose name contains 'router'
Search Criteria: Name = router; Object Class = Node
Example 2: Look up the object with a known IP address
Search Criteria: IP Address = 10.0.0.5
Example 3: List containers or subnets under a specific branch of the tree
Search Criteria: Parent Object ID = 123; Object Class = Container, Subnet