AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node operation retrieves the list of installed operating system patches for a specific device. It is useful in IT management and security scenarios where administrators need to audit patch status, verify compliance, or troubleshoot issues related to OS updates on managed devices.

Practical examples include:

  • Fetching all installed patches on a device to ensure it meets security standards.
  • Filtering patches by installation date to check recent updates.
  • Identifying failed patch installations to trigger remediation workflows.

Properties

Name Meaning
Id Device identifier (number) specifying which device's installed OS patches to retrieve.
Additional Query Parameters Optional filters to refine the query results:
- Status Patch status filter; possible values: FAILED, INSTALLED.
- Installed Before Include patches installed before this date (string, e.g., ISO 8601 format).
- Installed After Include patches installed after this date (string, e.g., ISO 8601 format).

Output

The node outputs JSON data representing the installed OS patches on the specified device. Each item typically includes details such as patch identifiers, names, installation dates, and statuses.

If binary data were involved (e.g., patch files), it would be summarized here, but this operation focuses on JSON metadata about patches.

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.
  • Relies on the external AvantGuard NinjaOne API endpoint that provides device patch information.

Troubleshooting

  • Missing or invalid device ID: Ensure the "Id" property is set correctly to a valid device identifier.
  • API authentication errors: Verify that the API key credential is properly configured and has necessary permissions.
  • Invalid date formats in filters: Use correct date string formats (ISO 8601 recommended) for "Installed Before" and "Installed After".
  • No patches returned: Confirm the device has installed patches matching the filter criteria; try removing filters to broaden the search.
  • Network or connectivity issues: Check network access to the API endpoint and proxy/firewall settings.

Links and References

Discussion