Endpoints
The HTTP API offers endpoints for interacting with and monitoring Rotonda at runtime:
- GET /status
Human readable application status information.
- GET /bmp-routers/
Base path. Use the
http_api_path
configuration setting for the correspondingbmp-tcp-in
component to change this URL.
- GET /bmp-routers/<ROUTER_ID>
This endpoint outputs information about the specified router if it is currently connected to the unit.
A HTML table showing all currently monitored routers and some basic information about them.
Three different forms of router ID are supported:
[SOURCE_IP]:[SOURCE_PORT]
, OR[sysName]
, OR[populated router_id_template]
Parameters:
<ROUTER_ID>
The id of the router to query information about.
- GET /prefixes/<IP_ADDR_PART>/<PREFIX_LENGTH>[?includeMoreSpecifics|includeLessSpecifics]
The RIB in the pipeline can be queried for prefixes with these URLs.
- GET /mrt/<MRT_UNIT_NAME>/queue?file=<FILENAME>
When configured with an update_path, a mrt-file-in can be instructed to add a file to its processing queue.
Parameters:
<FILENAME>
The path to an .mrt (or .gz, .bz2) file to be queued, relative to the configured update_path. The path may contain (relative) subdirectories, but the resulting file must reside under the configured update_path. For example, configured withupdate_path=my_mrt_files
,/queue?file=2025/01/30/updates1.mrt