Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Overview

This node interacts with the Druva MSP API to retrieve a License Usage Report for endpoints. It allows users to generate reports on license usage filtered by date ranges and optionally by specific customers. This is useful for MSP administrators or IT managers who want to monitor license consumption over time, analyze trends, or audit license allocation across their customer base.

Practical examples include:

  • Generating a report of license usage for the current month to review recent activity.
  • Fetching license usage data for a custom date range to analyze historical usage.
  • Filtering the report to only include certain customers to focus on key accounts.

Properties

Name Meaning
Date Selection Method Choose how to filter the report by date:
- All Dates (no date filtering)
- Specific Dates (select start and end dates)
- Relative Date Range (predefined ranges like current month, last 30 days, etc.)
Start Date The start date of the report period (required if "Specific Dates" is selected).
End Date The end date of the report period (required if "Specific Dates" is selected).
Date Range Select a predefined relative date range for the report period (required if "Relative Date Range" is selected). Options include Current Month, Previous Month, Last 30 Days, Year To Date, etc.
Filter by Customers Boolean flag to indicate whether to filter the report results by specific customer IDs.
Customer IDs List of customer IDs to include in the report (required if "Filter by Customers" is true). These are selectable from available customers.
Return All Whether to return all matching results or limit the output.
Limit Maximum number of results to return if "Return All" is false. Minimum value is 1.

Output

The node outputs JSON data representing the license usage report. Each item in the output array corresponds to a record in the report, typically including fields such as license counts, usage metrics, timestamps, and associated customer information.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Druva MSP API via an API key credential configured in n8n.
  • The node uses the Druva MSP API endpoint https://apis.druva.com.
  • The user must have appropriate permissions to access reporting endpoints and customer data within Druva MSP.

Troubleshooting

  • Common Issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Selecting "Specific Dates" without providing both start and end dates will result in validation errors.
    • Filtering by customers without selecting any customer IDs will cause the request to fail.
    • API rate limits or network issues may cause intermittent failures.
  • Error Messages:

    • Errors related to missing parameters will specify which required field is absent.
    • API errors will be returned in the output JSON under an error property if "Continue On Fail" is enabled.
    • If the resource or operation is not implemented, the node throws an error indicating the unsupported resource.
  • Resolutions:

    • Ensure API credentials are correctly set up and valid.
    • Provide all required date fields when using specific date filters.
    • When filtering by customers, select at least one valid customer ID.
    • Check network connectivity and API status if requests fail unexpectedly.

Links and References

Discussion