Actions83
- Bills Actions
- Alerts Actions
- Alert Rules Actions
- ARP Actions
- Devices Actions
- Device Groups Actions
- Inventory Actions
- Locations Actions
- Logs Actions
- Poller Groups Actions
- Ports Actions
- Port Groups Actions
- Routing Actions
- Services Actions
- Switching Actions
Overview
The node interacts with the LibreNMS network monitoring system, specifically allowing management of device groups. The "Remove Devices" operation under the "Device Groups" resource enables users to remove one or more devices from a specified device group by providing the group name and a list of device IDs.
This operation is useful in scenarios where network administrators need to update device group memberships dynamically, for example:
- Removing decommissioned or replaced devices from monitoring groups.
- Adjusting group membership after network topology changes.
- Cleaning up device groups to reflect current infrastructure.
Properties
| Name | Meaning |
|---|---|
| Group Name | The name of the device group from which devices will be removed. |
| Devices | A comma-separated list of device IDs to remove from the specified device group. |
Output
The node outputs JSON data representing the result of the removal operation. This typically includes confirmation of the devices removed or the updated state of the device group. The exact structure depends on the LibreNMS API response but generally confirms success or failure of the removal request.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to a LibreNMS instance via its API.
- Needs an API authentication token or key configured in the node credentials to authorize requests.
- The base URL of the LibreNMS API must be correctly set in the credentials.
- SSL certificate validation can be optionally disabled if using self-signed certificates.
Troubleshooting
- Invalid Group Name: If the specified device group does not exist, the API may return an error indicating the group was not found. Verify the group name spelling and existence.
- Invalid Device IDs: Providing device IDs that are not part of the group or do not exist may cause partial failures or errors. Ensure device IDs are correct and currently members of the group.
- Authentication Errors: Missing or incorrect API credentials will prevent successful requests. Confirm the API key/token and URL are valid.
- Network Issues: Connectivity problems to the LibreNMS server will cause request failures. Check network access and firewall settings.
- API Changes: If LibreNMS updates their API, some operations might change behavior or parameters. Consult the latest LibreNMS API documentation if unexpected errors occur.
Links and References
- LibreNMS Official Website
- LibreNMS API Documentation
- n8n Documentation - Creating Nodes (for general node development guidance)