Datto RMM

Interact with Datto RMM API to manage devices, sites, alerts, and monitoring

Actions59

Filter → Create Filter

AI-generated

Overview

This node operation creates a new custom filter in the Datto RMM system. It allows users to define a filter by specifying a name, description, filter criteria as a JSON object, filter type (such as device, site, alert, or mixed), and a category for organizational purposes. This is useful for users who want to create tailored filters to manage and query resources effectively within Datto RMM, such as filtering devices by hostname patterns or operating system.

Use Case Examples

  1. Creating a filter named 'Windows Servers' with criteria to include devices where the operating system is Windows.
  2. Creating a filter for alerts with specific priority or type to monitor critical issues.
  3. Defining a mixed filter that combines multiple resource types for comprehensive monitoring.

Properties

Name Meaning
Filter Name Name for the new custom filter, required to identify the filter.
Description Optional description providing details about the filter's purpose or usage.
Filter Criteria A JSON object defining the filter criteria, such as hostname patterns or operating system types, required to specify what the filter targets.
Filter Type Type of resource the filter applies to, such as device, site, alert, or mixed, to categorize the filter's scope.
Category Filter category for organization and grouping, such as monitoring, maintenance, reporting, automation, or custom user-defined categories.

Output

JSON

  • uid - Unique identifier of the created filter
  • name - Name of the created filter
  • description - Description of the created filter
  • criteria - JSON object representing the filter criteria
  • filterType - Type of resource the filter applies to
  • category - Category of the filter for organizational purposes

Dependencies

  • Datto RMM API with appropriate API key credentials

Troubleshooting

  • Ensure the filterName and criteria fields are provided and correctly formatted; missing or invalid JSON in criteria can cause errors.
  • Verify API credentials and network connectivity to Datto RMM API to avoid authentication or connection errors.
  • Check that the filterType and category values are valid options as per the node's configuration to prevent validation errors.

Discussion