Datto Backup icon

Datto Backup

Interact with Datto BCDR API for backup monitoring and management

Actions18

Agent → Get Many

AI-generated

Summary

Retrieve multiple backup agents associated with a specified BCDR device, optionally controlling the number of results returned and sorting order.

Inputs

  • Device Serial Number Name or ID (required) — Select the BCDR device by its serial number from the list or specify its ID using an expression.
  • Return All — Choose whether to return all agents or limit the number of results.
  • Limit — Specify the maximum number of agents to return if not returning all.
  • Options — Additional filtering options including sorting field and sort direction (ascending or descending).

Output shape

a list of agent objects associated with the specified BCDR device

If 'Return All' is true, returns all agents for the device, fetching all result pages transparently. If false, returns up to 'Limit' results. Sorting can be applied by 'name', 'os', 'localIp', or 'lastSnapshot' in ascending or descending order.

Examples

Example 1: Fetch up to 50 agents managed by a BCDR device with serial number 'ABC123', sorted by name ascending.

Set 'Device Serial Number Name or ID' to 'ABC123', 'Return All' to false, 'Limit' to 50, 'Sort By' to 'Name', and 'Sort Order' to 'Ascending'.

Links

Discussion