Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Actions79

Report - Usage → Get Itemized Tenant Quota

AI-generated

Overview

This node operation fetches detailed itemized tenant quota usage reports from the Druva MSP API. It supports filtering by date ranges (specific dates, relative date ranges, or all dates), customers, edition names, products, product modules, usage descriptions, MSP global ID, and MSP name. It is useful for MSP administrators or analysts who need to analyze tenant quota consumption in detail for billing, auditing, or resource management purposes.

Use Case Examples

  1. Generate a report of tenant quota usage for the previous month filtered by specific customers and product modules.
  2. Retrieve itemized quota usage for a specific date range without any filters to get a comprehensive usage overview.
  3. Analyze tenant quota usage for a particular MSP global ID to monitor resource allocation and consumption.

Properties

Name Meaning
Date Selection Method Choose whether to use specific dates, relative date ranges, or include all dates (no date filter). Options: All Dates, Specific Dates, Relative Date Range.
Start Date Start date for the usage report period. Required if 'Specific Dates' is selected.
End Date End date for the usage report period. Required if 'Specific Dates' is selected.
Date Range Select a predefined relative date range for billing period analysis. Required if 'Relative Date Range' is selected.
Filter by Customers Whether to filter results by specific customer IDs.
Customer IDs List of customer IDs to include in the report. Required if filtering by customers is enabled.
Filter by Edition Names Whether to filter results by specific edition names.
Edition Names List of edition names to include in the report. Required if filtering by edition names is enabled.
Filter by Products Whether to filter results by specific product IDs.
Product IDs List of product IDs to include in the report. Required if filtering by products is enabled.
Filter by Product Modules Whether to filter results by specific product module IDs.
Product Module IDs List of product module IDs to include in the report. Required if filtering by product modules is enabled.
Filter by Usage Descriptions Whether to filter results by specific usage descriptions.
Usage Descriptions List of usage descriptions to include in the report. Required if filtering by usage descriptions is enabled.
Filter by MSP Global ID Whether to filter results by a specific MSP global ID.
MSP Global ID MSP global ID to filter by (exact match). Required if filtering by MSP global ID is enabled.
Filter by MSP Name Whether to filter results by a specific MSP name.
MSP Name MSP name to filter by (exact match). Required if filtering by MSP name is enabled.
Return All Whether to return all results or only up to a given limit.
Limit Max number of results to return if 'Return All' is false.
Wrap Output Items When enabled, wraps all output items into a single item containing an array to prevent the next node from executing multiple times.
Wrapper Property Name The property name to use for the wrapped array of items in the output. Default is 'items'.

Output

JSON

  • tenantId - The unique identifier of the tenant for which the quota usage is reported.
  • quotaDetails - Detailed information about the tenant's quota usage, including itemized consumption data.
  • dateRange - The date range for which the quota usage report applies.
  • customerId - The customer ID associated with the tenant.
  • editionName - The edition name filter applied to the report, if any.
  • productId - The product ID filter applied to the report, if any.
  • usageDescription - The usage description filter applied to the report, if any.

Dependencies

  • Druva MSP API
  • An API key credential for Druva MSP API authentication

Troubleshooting

  • Ensure the API credentials are correctly configured and have the necessary permissions to access usage reports.
  • If the node returns no data, verify that the date range and filters are correctly set and that there is data available for the specified criteria.
  • Common error messages may include authentication errors, invalid date range errors, or filter validation errors. Check the error message details and adjust parameters accordingly.

Discussion