UniFi Site Manager icon

UniFi Site Manager

Manage UniFi devices and networks through the Site Manager API
Join our community

Actions5

Overview

The "Get Many" operation for the Device resource in this UniFi Site Manager node retrieves multiple device records from the UniFi Site Manager API. It is useful when you want to list devices managed by the UniFi system, optionally filtering them by specific host IDs or by their last processed timestamp. This operation supports fetching all devices or limiting the number of results returned.

Practical examples include:

  • Retrieving all devices connected to your UniFi network for inventory or monitoring purposes.
  • Filtering devices associated with particular hosts to analyze or manage subsets of your network.
  • Getting devices updated after a certain time to track recent changes or activity.

Properties

Name Meaning
Return All Whether to return all matching devices or only up to a specified limit.
Limit The maximum number of device records to return (used only if "Return All" is false).
Host IDs Filter devices by selecting one or more specific host IDs.
Last Processed Time Filter devices based on their last processed timestamp, returning only those processed after this time.

Output

The output consists of JSON objects representing devices retrieved from the UniFi Site Manager API. Each object contains detailed information about a device, such as its ID, name, status, and other relevant metadata as provided by the API.

If binary data were involved (e.g., device images or logs), it would be included in a separate binary property, but this operation focuses on JSON data describing devices.

Dependencies

  • Requires an API key credential for authenticating with the UniFi Site Manager API.
  • The node makes HTTP requests to https://api.ui.com to fetch device data.
  • The "Host IDs" property dynamically loads available hosts via an API call to /v1/hosts, so network connectivity and proper permissions are necessary.

Troubleshooting

  • No devices returned: Ensure that the API credentials are valid and have sufficient permissions. Also, verify that any filters applied (Host IDs, Last Processed Time) match existing devices.
  • API errors or timeouts: Check network connectivity to https://api.ui.com. If rate limits are exceeded, consider reducing request frequency or using pagination.
  • Invalid limit value: The limit must be at least 1; setting it lower may cause errors.
  • Empty Host IDs list: If filtering by Host IDs, ensure that the selected hosts exist and are accessible.

Links and References

Discussion