Files
librenms-librenms/doc/API/PortGroups.md
Jellyfrog 8f474dd4d4 Rework documentation (#13709)
* Rework documentation

* Slightly adjust theme

* wip

* fixes

* Remove unneeded header

* Re-added Acknowledgement.md file

* Added Acknowledgement.md to mkdocs.yml

Co-authored-by: Neil Lathwood <gh+n@laf.io>
2022-02-08 23:02:28 +00:00

56 lines
1.5 KiB
Markdown

### `get_graph_by_portgroup`
Get the graph based on the group type.
Route: `/api/v0/portgroups/:group`
- group is the type of port group graph you want, I.e Transit,
Peering, etc. You can specify multiple types comma separated.
Input:
- from: This is the date you would like the graph to start - See
<http://oss.oetiker.ch/rrdtool/doc/rrdgraph.en.html> for more information.
- to: This is the date you would like the graph to end - See
<http://oss.oetiker.ch/rrdtool/doc/rrdgraph.en.html> for more information.
- width: The graph width, defaults to 1075.
- height: The graph height, defaults to 300.
Example:
```curl
curl -H 'X-Auth-Token: YOURAPITOKENHERE' https://librenms.org/api/v0/portgroups/transit,peering
```
Output:
Output is an image.
### `get_graph_by_portgroup_multiport_bits`
Get the graph based on the multiple port id separated by commas `,`.
Route: `/api/v0/portgroups/multiport/bits/:id`
- id is a comma separated list of port ids you want, I.e 1,2,3,4,
etc. You can specify multiple IDs comma separated.
Input:
- from: This is the date you would like the graph to start - See
<http://oss.oetiker.ch/rrdtool/doc/rrdgraph.en.html> for more information.
- to: This is the date you would like the graph to end - See
<http://oss.oetiker.ch/rrdtool/doc/rrdgraph.en.html> for more information.
- width: The graph width, defaults to 1075.
- height: The graph height, defaults to 300.
Example:
```curl
curl -H 'X-Auth-Token: YOURAPITOKENHERE' https://librenms.org/api/v0/portgroups/multiport/bits/1,2,3
```
Output:
Output is an image.