Autotask icon

Autotask

Interact with Kaseya's Autotask PSA REST API to manage companies, tickets, contracts, and more.

Actions524

Configuration Item DNS Record → Get Many (Advanced)

AI-generated

Overview

This node operation retrieves multiple Configuration Item DNS Records from the Autotask PSA system using an advanced filter. It allows users to specify detailed query criteria in JSON format to filter the records returned. Users can choose to return all matching records or limit the number of records returned. Additional options include selecting specific columns to return, adding human-readable labels for picklist and reference fields, and flattening user-defined fields for easier access.

Use Case Examples

  1. A user wants to fetch all DNS records related to configuration items that match specific criteria, such as a particular domain or status, using a complex filter expressed in JSON.
  2. A user needs to retrieve up to 100 DNS records with selected fields and include human-readable labels for picklist fields to display in a report.

Properties

Name Meaning
returnAll Whether to return all results or only up to a given limit.
maxRecords Maximum number of records to return when returnAll is false. Range is 1 to 500.
advancedFilter A JSON string containing a "filter" array with Autotask API query criteria to filter the DNS records.
addPicklistLabels Whether to automatically add "_label" fields for picklist fields with human-readable values.
addReferenceLabels Whether to automatically add "_label" fields for reference fields with human-readable values.
selectColumns Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included.
flattenUdfs Whether to bring user-defined fields up to the top level of each object for easier access.

Output

JSON

  • id - Unique identifier of the DNS record.
  • name - Name of the DNS record.
  • type - Type of DNS record (e.g., A, CNAME, MX).
  • value - Value associated with the DNS record.
  • ttl - Time to live for the DNS record.
  • userDefinedFields - Array of user-defined fields related to the DNS record, if not flattened.
  • _label - Human-readable labels for picklist or reference fields, if enabled.

Dependencies

  • Autotask PSA REST API
  • API key credential for Autotask authentication

Troubleshooting

  • Ensure the advancedFilter JSON is correctly formatted and matches the Autotask API query criteria syntax to avoid query errors.
  • If no records are returned, verify the filter criteria and consider broadening the filter or enabling returnAll to fetch more data.
  • Check API credentials and permissions to ensure access to Configuration Item DNS Records.
  • If labels are not appearing as expected, verify that addPicklistLabels and addReferenceLabels options are enabled and that the fields have corresponding labels in Autotask.

Links

Discussion