AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node integrates with the AvantGuard NinjaOne API to retrieve information about operating systems. Specifically, the "Get Operating Systems" operation under the "Queries" resource allows users to fetch a list of operating systems monitored or managed by NinjaOne.

Common scenarios for this node include:

  • Inventory management: Automatically retrieving and updating the list of operating systems across devices.
  • Reporting: Generating reports on OS distribution within an organization.
  • Monitoring: Filtering and analyzing devices based on their operating system types.

For example, an IT administrator could use this node to pull all operating systems currently detected in their environment, optionally filtering by device or timestamp, to maintain up-to-date asset records.

Properties

Name Meaning
Additional Query Parameters Optional filters and pagination controls to refine the query results. Includes:
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 operating systems. The structure typically includes details such as OS names, versions, and possibly metadata related to monitoring timestamps or device associations.

If the API supports pagination, the output may also include cursor or paging tokens to fetch subsequent pages.

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating with the AvantGuard NinjaOne API.
  • The base URL for the API must be configured in the node credentials.
  • The node depends on the @avantguardllc/n8n-openapi-node package and the bundled OpenAPI specification (openapi.json) for request construction.

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) or timestamp (ts) are formatted correctly.
  • Pagination issues: When using cursors, ensure the cursor value is valid and corresponds to a previous response.
  • Network errors: Check connectivity to the configured base URL and that the NinjaOne API service is reachable.

Links and References

Discussion