AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node integrates with the AvantGuard NinjaOne platform to retrieve information about installed software patches on devices. Specifically, the "Get Installed Software Patches" operation allows users to query and filter patches based on various criteria such as device filters, patch type, impact, status, installation dates, and pagination controls.

This node is beneficial in scenarios where IT administrators or security teams need to audit patch compliance, track patch deployment status, or generate reports on software updates across managed devices. For example, it can be used to identify all critical patches installed after a certain date or to list patches for a specific product identifier.

Properties

Name Meaning
Additional Query Parameters Optional filters and parameters to refine the query results. Includes:
- Df (Device filter) Filter patches by specific device(s).
- Type Filter patches by patch type.
- Impact Filter patches by patch impact level.
- Status Filter patches by patch status.
- Product Identifier Filter patches by product identifier.
- Installed Before Include only patches installed before this date (string format expected).
- Installed After Include only patches installed after this date (string format expected).
- Cursor Cursor for pagination to continue from a previous result set.
- Page Size Limit the number of records returned per page (number).

These parameters are provided as a collection under "Additional Query Parameters" and allow flexible querying of installed software patches.

Output

The node outputs JSON data representing the list of installed software patches matching the query parameters. Each item in the output typically contains details about a patch such as its type, impact, status, installation date, associated device, and product identifier.

If the API supports pagination, the output may also include cursor information 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 platform.
  • The base URL for the API must be configured in the node credentials.
  • The node depends on the @avantguardllc/n8n-openapi-node package and uses an OpenAPI specification (openapi.json) bundled within the node for request building.

Troubleshooting

  • Authentication errors: Ensure that the API key credential is correctly configured and has sufficient permissions to access patch data.
  • Invalid query parameters: Verify that date strings and other filters conform to expected formats; incorrect values may cause API errors.
  • Pagination issues: If using cursors, ensure the cursor value is valid and corresponds to a previous response.
  • Empty results: Confirm that the filters applied actually match existing patches; try broadening filters to verify connectivity.
  • Network or API errors: Check network connectivity and API service status; transient errors may require retries.

Links and References

Discussion