Netinfra Routing

DELETE /netinfra/routing/kernel/routes

Delete a static kernel route

Removes a static (proto static) IPv4 route from the node’s Linux FIB.

Query Parameters:

• dst (string) – Destination CIDR to remove, e.g. 10.20.0.0/16

Status Codes:

• 200 OK – deleted

• 400 Bad Request – missing or invalid dst

• 404 Not Found – no route to this destination

• 409 Conflict – route exists but is not a static route

• 500 Internal Server Error – netlink error

GET /netinfra/routing/kernel/routes

Get kernel routing table

The node’s kernel routing table (the Linux FIB, i.e. ip route show).

Query Parameters:

• protocol (string) – filter by route protocol: static, kernel, bgp, boot, dhcp

• dev (string) – filter by egress interface, e.g. cloudbr0

• search (string) – case-insensitive substring search over dst, gateway, dev (alias: q)

Status Codes:

• 200 OK – routes + count

• 500 Internal Server Error – netlink error

POST /netinfra/routing/kernel/routes

Add a static kernel route

Installs an IPv4 static route in the node’s Linux FIB (ip route add).

Request JSON Object:

• dev (string) – egress interface name (required)

• dst (string) – destination CIDR, e.g. 10.20.0.0/16 (required)

• gateway (string) – next-hop IP; omit for a link-scoped route

• metric (integer) – route metric (priority); 0 = kernel default

Status Codes:

• 201 Created – the installed route

• 400 Bad Request – bad request or unknown interface

• 409 Conflict – route already exists

• 500 Internal Server Error – netlink error