Overview
The node "UniFi Site Manager" integrates with the UniFi Site Manager API, allowing users to manage and retrieve information about network resources such as devices, hosts, and sites. Specifically, for the Device - Get Many operation, it fetches multiple device records associated with a specified host ID. This is useful in scenarios where network administrators want to list all devices connected to or managed under a particular host within their UniFi network environment.
Practical examples include:
- Retrieving all devices connected to a specific access point or controller.
- Auditing devices on a given host for monitoring or troubleshooting.
- Automating inventory management of network hardware.
Properties
| Name | Meaning |
|---|---|
| Host ID | The unique identifier of the host for which to retrieve all associated devices. Required. |
Output
The node outputs JSON data representing an array or collection of device objects related to the specified Host ID. Each device object typically contains details such as device identifiers, status, configuration, and other metadata provided by the UniFi Site Manager API.
If the node supports binary data output (not evident from the provided code), it would represent any binary attachments or files related to devices, but this is not indicated here.
Dependencies
- Requires an active connection to the UniFi Site Manager API endpoint (
https://api.ui.com/ea). - Needs an API key credential configured in n8n to authenticate requests.
- The node depends on internal modules handling transport and routing of API calls.
- No additional external services beyond the UniFi API are required.
Troubleshooting
- Invalid API Key Error: If the API key is incorrect or expired, the node will return an authentication error. Ensure the API key credential is valid and has appropriate permissions.
- Missing Host ID: Since the Host ID property is required, omitting it will likely cause the node to fail or return no results. Always provide a valid Host ID.
- Network Issues: Connectivity problems to the UniFi API endpoint can cause timeouts or failures. Verify network access and endpoint availability.
- Unexpected API Response: Changes in the UniFi API or rate limiting might cause errors. Check API documentation and logs for updates or limits.
Links and References
- UniFi Site Manager API Documentation (official API base URL; detailed docs may be available through Ubiquiti's developer resources)
- UniFi Network Management (general product information)
Note: The summary is based solely on static analysis of the provided source code and property definitions.