Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Overview

This node interacts with the Druva MSP API to perform various operations on multiple resources, including administrators. Specifically, for the Admin resource with the Get Many operation, it retrieves a list of administrator accounts from the Druva MSP system. Users can fetch all administrators or limit the number of results, and optionally filter the list by email address or role.

This node is beneficial in scenarios where you need to automate management or reporting of administrator accounts within Druva MSP, such as auditing admin access, syncing admin data with other systems, or filtering admins based on roles or emails for targeted notifications.

Example use cases:

  • Retrieve all administrators to generate an audit report.
  • Fetch only administrators with a specific role to assign tasks or permissions.
  • Filter administrators by email to verify account status or details.

Properties

Name Meaning
Return All Whether to return all administrator records or limit the number of results returned.
Limit Maximum number of administrator records to return (used if "Return All" is false).
Filter by Email Whether to filter the administrators by their email address.
Email The email address to filter administrators by (used if "Filter by Email" is true).
Filter by Role Whether to filter the administrators by their role(s).
Role One or more administrator roles to filter by (used if "Filter by Role" is true).

Output

The node outputs an array of JSON objects representing administrator records. Each object typically contains administrator details such as:

  • id or adminId: Unique identifier of the administrator.
  • firstName: Administrator's first name.
  • lastName: Administrator's last name.
  • email: Administrator's email address.
  • Other relevant metadata fields as provided by the Druva MSP API.

If the node encounters errors during execution and "Continue On Fail" is enabled, the output will include error objects with an error field describing the issue.

The node does not output binary data.

Dependencies

  • Requires an active connection to the Druva MSP API via an API key credential configured in n8n.
  • The base URL for API requests is https://apis.druva.com.
  • Pagination handling is implemented internally to support fetching all items when requested.

Troubleshooting

  • Common issues:

    • API authentication failures due to invalid or missing API credentials.
    • Network connectivity problems preventing access to the Druva MSP API.
    • Filtering parameters that do not match any administrators, resulting in empty output.
    • Exceeding API rate limits or request quotas.
  • Error messages:

    • Errors thrown by the node will include messages from the Druva MSP API or internal processing errors.
    • If "Continue On Fail" is disabled, the node will stop execution on the first error.
    • To handle partial failures gracefully, enable "Continue On Fail" to receive error details in the output.
  • Resolution tips:

    • Verify API credentials and permissions.
    • Check network connectivity and proxy settings.
    • Confirm filter values (email, roles) are correct and exist in the system.
    • Review Druva MSP API documentation for rate limits and usage guidelines.

Links and References

Discussion