Skip to content

Routers¶

OpenStack routers connect private networks to external networks, enabling outbound internet access and inbound traffic via floating IPs.

Endpoints¶

Method	Path	Description
`GET`	`/cloud/routers?project_id=<uuid>`	List routers
`GET`	`/cloud/routers/{id}?project_id=<uuid>`	Show a router

List routers¶

GET /cloud/routers?project_id=<uuid>
Authorization: Bearer <token>

Show a router¶

GET /cloud/routers/{id}?project_id=<uuid>
Authorization: Bearer <token>

Response fields:

Field	Description
`id`	OpenStack router UUID
`name`	Display name
`status`	`ACTIVE`, `DOWN`, `BUILD`, `ERROR`
`admin_state_up`	Whether the router is administratively enabled
`external_gateway_info`	Object describing the external network connection; `null` if not connected
`routes`	Array of static routes (`{destination, nexthop}`)
`availability_zones`	AZs where the router is active

Typical architecture¶

Internet
    │
    ▼
[External network]
    │
    ▼
[Router]  ◄── external_gateway_info points here
    │
    ▼
[Private network / subnet]  (10.0.0.0/24)
    │
    ▼
[Servers]

To give a server outbound internet access, attach its subnet to a router that has an external gateway configured. To give it a public IP, assign a a floating IP through the router.

Networks — private networks and subnets
Floating IPs — assign public IPs via the router (managed via the OpenStack dashboard or CLI)
Servers — the compute resources connected through routers