netinfra-registry

GET /netinfra/platforms

List supported platforms

Returns the list of switch NOS platforms Karios can peer with

Status Codes:

• 200 OK – platforms array and count

GET /netinfra/registry/routing-hosts

List all BGP routers

Returns all nodes with an active VTEP (backed by bmc_infos)

Status Codes:

• 200 OK – OK

• 500 Internal Server Error – Internal Server Error

• 503 Service Unavailable – Database not initialized

Response JSON Object:

• bgp_routers[].cloudstack_host_id (string) – Association with CloudStack host

• bgp_routers[].fqdn (string)

• bgp_routers[].ip_address (string)

• bgp_routers[].is_route_reflector (boolean) – Route reflector

• bgp_routers[].last_checked (string)

• bgp_routers[].last_error (string)

• bgp_routers[].name (string)

• bgp_routers[].router_id (string) – Routing configuration

• bgp_routers[].status (string) – Status tracking

• bgp_routers[].vtep_ip (string) – VTEP IP allocated to this node

• count (integer)

POST /netinfra/registry/routing-hosts

Register a BGP router (deprecated)

No longer used. Nodes are registered automatically during EVPN setup via bmc_infos.

Status Codes:

• 410 Gone – Gone

DELETE /netinfra/registry/routing-hosts/by-db-id/{id}

Delete a BGP router by database ID (deprecated)

Not registered in routes. Use DELETE /routing-hosts/{id} with VTEP IP instead.

Parameters:

• id (integer) – BGP Router database ID

Status Codes:

• 410 Gone – Gone

DELETE /netinfra/registry/routing-hosts/{id}

Delete a BGP router by VTEP IP

Clears SDN state (vtep_ip, sdn_status) from the node with the given VTEP IP

Parameters:

• id (string) – VTEP IP

Status Codes:

• 200 OK – OK

• 404 Not Found – No node with given VTEP IP

• 500 Internal Server Error – Internal Server Error

• 503 Service Unavailable – Database not initialized

Response JSON Object:

• id (integer)

• message (string)

• name (string)

• status (string)

GET /netinfra/registry/routing-hosts/{id}

Get a BGP router by OS IP

Returns a single node’s SDN info by its OS IP address

Parameters:

• id (string) – Node OS IP address

Status Codes:

• 200 OK – OK

• 404 Not Found – Node not found or no SDN config

• 500 Internal Server Error – Internal Server Error

• 503 Service Unavailable – Database not initialized

Response JSON Object:

• cloudstack_host_id (string) – Association with CloudStack host

• fqdn (string)

• ip_address (string)

• is_route_reflector (boolean) – Route reflector

• last_checked (string)

• last_error (string)

• name (string)

• router_id (string) – Routing configuration

• status (string) – Status tracking

• vtep_ip (string) – VTEP IP allocated to this node

PUT /netinfra/registry/routing-hosts/{id}

Update a BGP router

Updates SDN status fields on a node identified by its OS IP

Parameters:

• id (string) – Node OS IP address

Request JSON Object:

• cloudstack_host_id (string)

• is_route_reflector (boolean)

• last_error (string)

• status (string)

Status Codes:

• 200 OK – OK

• 404 Not Found – Node not found

• 500 Internal Server Error – Internal Server Error

• 503 Service Unavailable – Database not initialized

Response JSON Object:

• cloudstack_host_id (string) – Association with CloudStack host

• fqdn (string)

• ip_address (string)

• is_route_reflector (boolean) – Route reflector

• last_checked (string)

• last_error (string)

• name (string)

• router_id (string) – Routing configuration

• status (string) – Status tracking

• vtep_ip (string) – VTEP IP allocated to this node