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 integrates with the LibreNMS network monitoring system, specifically allowing management of port groups. The "Assign Ports" operation lets users assign multiple ports to a specified port group by providing the port group ID and a list of port IDs. This is useful in scenarios where network administrators want to organize or re-organize ports into logical groups for easier management, monitoring, or applying configurations collectively.
Practical examples include:
- Grouping all ports connected to a specific switch or device segment.
- Assigning newly added ports to an existing port group for monitoring.
- Automating port assignments during network provisioning workflows.
Properties
| Name | Meaning |
|---|---|
| Port Group ID | The unique identifier of the port group to which ports will be assigned. |
| Port IDs | A comma-separated list of port IDs that should be assigned to the specified port group. |
Output
The node outputs JSON data representing the result of the assignment operation. Typically, this includes confirmation of the ports being successfully assigned to the port group or details about any errors encountered. The exact structure depends on the LibreNMS API response but generally contains status information and possibly updated port group details.
No binary data output is involved in this operation.
Dependencies
- Requires connection to a LibreNMS instance via its REST API.
- Needs an API authentication token configured in the node credentials to authorize requests.
- The base URL of the LibreNMS API must be correctly set in the credentials.
- Optionally, SSL certificate validation can be disabled if using self-signed certificates.
Troubleshooting
- Invalid Port Group ID: If the provided port group ID does not exist, the API will return an error. Verify the ID is correct and exists in LibreNMS.
- Malformed Port IDs: Ensure the port IDs are provided as a comma-separated string without extra spaces or invalid characters.
- Authentication Errors: Check that the API token is valid and has sufficient permissions.
- Network Issues: Confirm connectivity to the LibreNMS server and that the base URL is correct.
- API Changes: If LibreNMS updates their API, some responses or required parameters might change; verify compatibility.