Druva MSP icon

Druva MSP

Interact with the Druva MSP API

Actions79

Report - Enterprise Workloads → Get M365 Alerts Report

AI-generated

Overview

This node interacts with the Druva MSP API to retrieve Microsoft 365 Alerts Reports under the 'Report - Enterprise Workloads' resource. It is useful for MSPs or administrators who want to monitor and analyze security alerts and incidents within their Microsoft 365 environment. The node supports filtering by date ranges (specific dates, relative date ranges, or no date filter), limiting the number of results, and filtering by specific customers. It can return all results or a limited subset based on user preference. The output can be wrapped into a single item to simplify downstream processing.

Use Case Examples

  1. An MSP wants to generate a report of all M365 alerts for the previous month across multiple customers to identify security trends.
  2. A security administrator needs to fetch M365 alerts for a specific date range to investigate a recent security incident.
  3. A user wants to limit the report to a maximum of 50 alerts and filter the results to specific customers they manage.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return when 'Return All' is false.
Date Selection Method Choose whether to use specific dates, relative date ranges, or include all dates (no date filter).
Start Date Start date for filtering report data (inclusive), used when 'Specific Dates' is selected.
End Date End date for filtering report data (inclusive), used when 'Specific Dates' is selected.
Date Range Predefined relative date range for filtering report data, used when 'Relative Date Range' is selected.
Filter by Customer(s) Whether to filter results by specific customers.
Customer IDs IDs of the customers to filter by, used when 'Filter by Customer(s)' is true.
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

  • json
    • error - Error message if the operation fails for a specific item.
    • items - When output is wrapped, contains an array of all output items.
    • count - When output is wrapped, contains the count of all output items.

Dependencies

  • Druva MSP API with appropriate API key credentials

Troubleshooting

  • Ensure the API credentials are correctly configured and have permissions to access the M365 alerts report.
  • If the node returns an error related to resource not implemented, verify that the resource 'Report - Enterprise Workloads' and operation 'Get M365 Alerts Report' are supported in the current version of the node.
  • If filtering by customers, ensure the customer IDs are valid and accessible by the API credentials.
  • If no data is returned, check the date filters and ensure there is data available for the selected date range.

Discussion