User-Defined Links

User-defined links (UDLs) for the enlinkd topology can be be queried, added, modified, or deleted via REST endpoints.

GETs (reading UDLs)

User-defined link API GET functions
Resource Description

api/v2/userdefinedlinks

Get the list of UDLs.

api/v2/userdefinedlinks/{id}

Retrieve a specific UDL by database ID.

POST (Creating UDLs)

User-defined link API POST function
Resource Description

api/v2/userdefinedlinks

Add a new UDL.

Use examples with cURL

Create a new UDL between node with ID 1 and node with ID 2.
curl -v -X POST -u admin:admin -H "Content-Type: application/json" -d '{"node-id-a": 1, "node-id-z": 2, "component-label-a": "tp1", "component-label-z": "tp2", "link-id": "n1:tp1->n2:tp2", "owner": "me"}' http://localhost:8980/opennms/api/v2/userdefinedlinks

DELETE (removing UDLs)

User-defined link API DELETE function
Resource Description

api/v2/userdefinedlinks/{id}

Delete a UDL by database ID.