Datto RMM

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

Actions59

Audit → Get Hardware Audit

AI-generated

Overview

This node operation retrieves hardware audit information for a specified device from the Datto RMM system. It is useful for IT administrators and technicians who need detailed hardware inventory data such as CPU, memory, storage, network interfaces, or graphics information for devices managed within Datto RMM. For example, it can be used to monitor hardware changes, verify hardware configurations, or generate reports on device hardware status.

Use Case Examples

  1. Retrieve all hardware audit records for a specific device including archived data within a date range.
  2. Filter hardware audit data to only include processor or memory information for a device.
  3. Paginate through hardware audit records when retrieving large datasets to manage API response size.

Properties

Name Meaning
Device Select the device to retrieve hardware audit information for. This is a required field and uses a dynamic list of devices from the system.
Include Archived Boolean flag to include archived or historical hardware audit data in the response.
Start Date Start date filter for historical audit data in ISO 8601 format. Only applicable if including archived data.
End Date End date filter for historical audit data in ISO 8601 format. Only applicable if including archived data.
Hardware Category Filter hardware audit data by specific category such as processor, memory, storage, network, or graphics.
Retrieve All Boolean flag to automatically retrieve all audit records using pagination.
Page Page number for paginated results, 1-based index. Used only if not retrieving all records automatically.
Max Results Maximum number of results to return per page. Used only if not retrieving all records automatically.
Include Details Boolean flag to include detailed audit information, which may increase the response size.
Fields to Include Select which fields to include in the response, allowing customization of the returned data.

Output

JSON

  • hardwareAuditData - The main hardware audit information retrieved for the specified device, filtered by category and date if applicable.
  • paginationInfo - Details about pagination such as current page, total pages, and total records when pagination is used.

Dependencies

  • Datto RMM API with appropriate API key credentials

Troubleshooting

  • Ensure the device UID is valid and the device exists in the Datto RMM system to avoid errors.
  • If including archived data, verify that the start and end dates are in correct ISO 8601 format and that the date range is valid.
  • When retrieving large datasets, use the 'Retrieve All' option to avoid missing records due to pagination limits.
  • If the API returns errors related to permissions, check that the API key credentials have sufficient access rights to audit data.

Discussion