Actions159
- Related Items Actions
- Backup Actions
- Queries Actions
- Get Disk Drives
- Get Operating Systems
- Get RAID Controller Report
- Get Volumes
- Get Computer Systems
- Get Antivirus Status Report
- Get Device Health Report
- Get Custom Fields Report
- Get Installed Software Patches
- Get Custom Fields Detailed Report
- Get Installed OS Patches
- Get Pending Failed Rejected OS Patches
- Get RAID Drive Report
- Get Windows Services Report
- Get Antivirus Threats
- Get Device Usage
- Get Network Interfaces
- Get Processors
- Get Software
- Get Last Logged On Users Report
- Get Policy Overrides 1
- Get Scoped Custom Fields Report
- Get Pending Failed Rejected Software Patches
- Get Scoped Custom Fields Detailed Report
- System Actions
- Knowledge Base Articles Actions
- Get Knowledge Base Article Signed Urls
- Get Related Item Attachments Signed Urls
- Download Knowledge Base Article
- Get Knowledge Base Folder Path Content
- Upload Temp Attachments
- Get Knowledge Base Folder Content
- Get Client Knowledge Base Articles
- Upload Knowledge Base Articles
- Get Global Knowledge Base Articles
- Download Related Item Attachment
- Organization Documents Actions
- Document Templates Actions
- Checklist Templates Actions
- Organization Checklists Actions
- Location Actions
- Management Actions
- Get Custom Fields Policy Condition
- Delete Policy Condition
- Reset Alert
- Update Device
- Request Scripting Options
- Submit OS Patch Scan
- Get Installer For Location
- Get Windows Event Policy Conditions
- Create Organization
- Cancel Device Maintenance
- Reboot Devices
- Set Windows Service Configuration
- Create Location For Organization
- Update Node Role Policy Assignment For Organization
- Create Windows Event Policy Condition
- Node Approval Operation
- Control Windows Service
- Remove Device Owner
- Submit OS Patch Apply
- Get Installer
- Create Policy
- Get Windows Event Policy Condition
- Update Device Maintenance
- Reset Policy Overrides
- Set Device Owner
- Submit Software Patch Scan
- Update Location
- Reset Alert Set Activity Data
- Get Device Link
- Run Script On Device
- Submit Software Patch Apply
- Update Organization
- Create Custom Fields Policy Condition
- Get Custom Fields Policy Conditions
- Custom Fields Actions
- Ticketing Actions
- Organization Actions
- Devices Actions
- Get Device Active Jobs
- Get Device Installed Software Patches
- Get Device Processors
- Update Node Attribute Values
- Get Device Disk Drives
- Get Device Pending Failed Rejected OS Patches
- Get Device Volumes
- Get Device Alerts
- Get Device Network Interfaces
- Get Device Software
- Get Device Activities
- Get Device Last Logged On User
- Get Device Services
- Get Policy Overrides
- Get Device
- Get Device Installed OS Patches
- Get Device Pending Failed Rejected Software Patches
- Get Node Custom Fields
- Groups Actions
- Webhooks Actions
Overview
This node integrates with the AvantGuard NinjaOne API to retrieve information about computer systems. Specifically, the "Get Computer Systems" operation under the "Queries" resource allows users to fetch details about managed devices or endpoints in their environment. This can be useful for IT administrators who want to monitor device status, inventory hardware, or gather system data for reporting and management purposes.
Practical examples include:
- Fetching a list of all computer systems currently monitored.
- Filtering devices based on specific criteria such as device type or monitoring timestamp.
- Paginating through large sets of device records to process them incrementally.
Properties
| Name | Meaning |
|---|---|
| Additional Query Parameters | Optional parameters to refine the query results. These include: - Df: Device filter (string) - Ts: Monitoring timestamp filter (string) - Cursor: Cursor name for pagination (string) - Page Size: Limit number of records per page (number) |
Output
The node outputs JSON data representing the retrieved computer systems. The structure typically includes an array of device objects with their respective properties as returned by the NinjaOne API. Each object may contain details such as device identifiers, status, timestamps, and other metadata relevant to the computer systems.
If the API supports binary data (e.g., file attachments or reports), the node would handle it accordingly, but based on the provided code and operation, the output is primarily JSON-formatted system data.
Dependencies
- Requires an API key credential for authenticating with the AvantGuard NinjaOne service.
- The base URL for the API must be configured in the node credentials.
- Depends on the
@avantguardllc/n8n-openapi-nodepackage for building request properties from the OpenAPI specification.
Troubleshooting
- Authentication errors: Ensure that the API key credential is correctly set up and has sufficient permissions.
- Invalid query parameters: Verify that optional filters like device filter (
df) and timestamp (ts) are formatted correctly according to the API documentation. - Pagination issues: When using cursor and page size parameters, ensure proper handling of cursors returned by previous requests to avoid missing or duplicating records.
- Network or API downtime: Check network connectivity and the status of the NinjaOne API service if requests fail unexpectedly.
Links and References
- AvantGuard NinjaOne API Documentation (general reference for API endpoints and parameters)
- n8n Documentation on Creating Custom Nodes
- OpenAPI Specification (for understanding how the node builds requests)