Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Actions79

Report - Endpoint → Get User Rollout Report

AI-generated

Overview

This node interacts with the Druva MSP API to retrieve a User Rollout Report from the Report - Endpoint resource. It allows users to specify date filters (all dates, specific dates, or relative date ranges), filter by customer IDs, and filter by rollout status. The node supports pagination with options to return all results or limit the number of results. It also provides an option to wrap all output items into a single item containing an array to prevent multiple executions of the next node. This node is useful for MSP administrators or analysts who need detailed rollout status reports for users across different customers and time periods.

Use Case Examples

  1. Generate a report of user rollout statuses for the previous month filtered by specific customers.
  2. Retrieve all user rollout reports without date filtering to analyze overall rollout progress.
  3. Get a user rollout report for a custom date range and filter by rollout status 'Completed' and 'In Progress'.

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 report period, required if 'Specific Dates' is selected.
End Date End date for the report period, required if 'Specific Dates' is selected.
Date Range Select a predefined relative date range for the report, 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.
Filter by Rollout Status Whether to filter results by rollout status.
Rollout Status Rollout status values to filter by, such as Completed, In Progress, Not Started, or Failed.
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return if not returning all.
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

  • userRolloutReport - The user rollout report data retrieved from the Druva MSP API, containing details about rollout statuses filtered by the specified parameters.

Dependencies

  • Druva MSP API with appropriate API key credentials

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access the Report - Endpoint resource.
  • If filtering by customers or rollout status, verify that the provided IDs and status values are valid and exist in the system.
  • Check date parameters for correct format and logical consistency (e.g., start date is before end date).
  • If the node returns no data, try adjusting the date filters or removing some filters to broaden the query.
  • Enable 'Wrap Output Items' carefully as it changes the output structure and may affect downstream nodes expecting individual items.

Discussion