Druva MSP icon

Druva MSP

Interact with the Druva MSP API
Join our community

Actions39

Overview

The "Get Storage Consumption by BackupSets Report" operation within the "Report - Hybrid Workloads" resource fetches detailed storage consumption data related to backup sets in a hybrid workload environment. This report is useful for MSPs (Managed Service Providers) or IT administrators who need to monitor and analyze how storage resources are being utilized across various backup sets, helping optimize storage allocation and cost management.

Typical use cases include:

  • Tracking storage usage trends over specific time periods.
  • Filtering storage consumption data by customers or workload types to focus on particular segments.
  • Generating reports for billing or capacity planning based on backup set storage consumption.

For example, an MSP might use this node to generate a monthly report showing which customers or workload types consumed the most storage, enabling targeted optimization or customer billing.

Properties

Name Meaning
Return All Whether to return all available results or limit the output to a specified number of entries.
Limit The maximum number of results to return when "Return All" is false. Acceptable values range from 1 to 100.
Date Selection Method Choose how to filter the report data by date:
• No Date Filter — include all dates.
• Specific Dates — filter between a start and end date.
• Relative Date Range — select from predefined relative ranges like current month, last 30 days, etc.
Start Date The inclusive start date for filtering report data (used only if "Specific Dates" is selected).
End Date The inclusive end date for filtering report data (used only if "Specific Dates" is selected).
Date Range Predefined relative date ranges for filtering report data (used only if "Relative Date Range" is selected). Options include Current Month, Previous Month, Last 30 Days, Year To Date, etc.
Filter by Customer(s) Whether to filter the report results by specific customers.
Customer IDs List of customer IDs to filter the report by (shown only if filtering by customers is enabled).
Filter by Workload Types Whether to filter the report results by workload types.
Workload Types List of workload types to filter by (shown only if filtering by workload types is enabled). For alert history reports, this filters by alert type instead.

Output

The node outputs JSON data representing the storage consumption details by backup sets according to the applied filters. The structure typically includes fields such as backup set identifiers, associated customers, workload types, storage consumed, and timestamps reflecting the filtered date range.

If binary data were involved (e.g., file exports), it would be summarized accordingly; however, this operation focuses on JSON report data.

Dependencies

  • Requires an active connection to the Druva MSP API via an API key credential configured in n8n.
  • The node depends on the Druva MSP API endpoints that provide customer, workload, and report data.
  • Proper permissions and API access rights are necessary to retrieve report data.

Troubleshooting

  • Common Issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Selecting incompatible date filters (e.g., missing start or end dates when "Specific Dates" is chosen) may result in errors or empty responses.
    • Filtering by customers or workload types without valid IDs or options can lead to no data returned.
    • Exceeding the limit without enabling "Return All" may truncate results unexpectedly.

  • Error Messages:

    • Authentication errors usually indicate invalid or expired API keys; reconfigure credentials.
    • Validation errors about date parameters suggest checking that required dates are provided when using specific date filters.
    • API rate limits or network issues may cause request failures; retry after some time or check connectivity.

Links and References

Discussion