Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Overview

The "Get Data Protection Risk Report" operation within the "Report - Cyber Resilience" resource of this node fetches a report detailing data protection risks across specified customers and workloads. This report helps organizations assess their cyber resilience posture by identifying risk levels, connection statuses, and workload types over a selected date range.

Common scenarios for using this node include:

  • Security teams monitoring data protection risks to prioritize mitigation efforts.
  • Compliance officers generating periodic reports on data protection status.
  • IT administrators filtering risk reports by specific customers or workload types to focus on critical assets.

For example, a user might request a report for all servers and databases with high or medium risk levels connected in the last 30 days to quickly identify vulnerable systems.

Properties

Name Meaning
Date Selection Method Choose how to filter the report by date:
• All Dates (no date filter)
• Specific Dates (select start and end dates)
• Relative Date Range (predefined ranges like current month, last 30 days, etc.)
Start Date The start date for the report period (required if "Specific Dates" is chosen).
End Date The end date for the report period (required if "Specific Dates" is chosen).
Date Range Select a predefined relative date range for the report (required if "Relative Date Range" is chosen). Options include current/previous month, quarter, year, last 30/60/90 days, last 6/12 months, year to date, etc.
Filter by Customers Boolean flag to enable filtering the report by specific customer IDs.
Customer IDs List of customer IDs to include in the report (required if filtering by customers).
Filter by Workload Types Boolean flag to enable filtering the report by workload types.
Workload Types Workload types to filter by when enabled. Options: Server, VM, NAS, Database.
Filter by Connection Status Boolean flag to enable filtering the report by connection status.
Connection Status Connection status values to filter by when enabled. Options: Connected, Disconnected, Intermittent.
Filter by Risk Levels Boolean flag to enable filtering the report by risk levels.
Risk Levels Risk level values to filter by when enabled. Options: High, Medium, Low.
Return All Whether to return all results or limit the number of returned items.
Limit Maximum number of results to return if not returning all. Minimum value is 1. Default is 100.

Output

The node outputs JSON data representing the data protection risk report entries matching the specified filters. Each item typically includes details such as:

  • Customer information
  • Workload type
  • Connection status
  • Risk level
  • Relevant timestamps within the selected date range
  • Other metadata related to data protection risks

If binary data were involved (e.g., report files), it would be summarized here, but this operation returns structured JSON data only.

Dependencies

  • Requires an API key credential for authenticating with the Druva MSP API.
  • The node interacts with the Druva MSP cloud service endpoint at https://apis.druva.com.
  • Proper permissions are needed on the API key to access cyber resilience reports.
  • The node uses internal helper functions to paginate and retrieve all relevant data from the API.

Troubleshooting

  • Empty or incomplete results: Verify that the date filters and other filters (customers, workload types, risk levels) are correctly set and that the API key has access to the requested data.
  • API authentication errors: Ensure the API key credential is valid and has not expired.
  • Limit exceeded errors: If not returning all results, ensure the limit parameter is within allowed bounds.
  • Network or timeout issues: Check network connectivity to the Druva MSP API endpoint.
  • Error messages containing "resource not implemented": Confirm that the resource parameter is set to "reportCyber" and the operation to "getDataProtectionRisk".

Links and References

Discussion