cliffalbert / LibreNMSAPI

Python libreNMS API

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

LibreNMSAPI

A Python API client library for (https://www.librenms.org/ "LibreNMS").
LibreNMS is a fully featured network monitoring system that provides a wealth of features and device support.

Installation

Add the folder LibreNMSAPI to your project this way it can be used as module.

Quick start

To begin import the API and create an instance of the LibreNMSAPI class.

from LibrenmsAPI.LibreNMSAPI import LibreNMSAPI

# Do not use a trailing slasg for the URL
api = librenmsAPI(
  token = "token"
  url= "https://librenms.example.com/api/v0"
)

Queries

You can reach all endpoints inside the LibreNMS API by calling there routes as attribute of the LibreNMSAPI instance.
All queries return an Endpoint that can again be queried and in some cases contain the data from the queries endpoint (if any).
For example:

all_devices = api.devices.all()
for device in devices:
  print(device.device_id)

specific_device = api.devices.get("s01.example.com")
if specific_device:
  print(device.device_id)

specific_device.delete()

Contributing

If you want to contribute please fork this project, push your changes and send a pull request.

About

Python libreNMS API

License:MIT License


Languages

Language:Python 100.0%