AvantGuard - NinjaOne icon

AvantGuard - NinjaOne

AvantGuard - NinjaOne

Actions159

Overview

This node operation retrieves the list of pending, failed, or rejected operating system patches for a specific device. It is useful in IT management and security scenarios where administrators need to monitor patch compliance and identify devices that require attention due to uninstalled or problematic OS patches. For example, an IT admin can use this node to fetch all critical patches that have failed on a particular device to prioritize remediation efforts.

Properties

Name Meaning
Id The unique identifier of the device for which to retrieve OS patch information.
Additional Query Parameters Optional filters to refine the patch results:
- Status Filter patches by their status (e.g., pending, failed, rejected).
- Type Filter patches by type (e.g., security, feature update).
- Severity Filter patches by severity level (e.g., critical, important).

Output

The node outputs JSON data containing details about the OS patches matching the specified criteria for the given device. This typically includes patch metadata such as patch ID, name, status, type, severity, and other relevant attributes. The output does not include binary data.

Dependencies

  • Requires an API key credential for authenticating with the external service.
  • Needs the base URL of the API configured in the node credentials.
  • Depends on the external AvantGuard NinjaOne API to fetch device patch information.

Troubleshooting

  • Common issues:

    • Invalid or missing device ID will result in no data or errors.
    • Incorrect API credentials or base URL configuration will cause authentication failures.
    • Using unsupported filter values in additional query parameters may return empty results or errors.
  • Error messages:

    • Authentication errors indicate invalid or expired API keys; verify and update credentials.
    • "Device not found" errors suggest the provided device ID does not exist; confirm the ID.
    • Query parameter validation errors mean the filters used are not recognized; check allowed values.

Links and References

Discussion