router

A router is a logical component that forwards data packets between networks. It also provides Layer 3 and NAT forwarding to provide external network access for servers on project networks.

Network v2

router add port

Add a port to a router

os router add port
    <router>
    <port>
<router>

Router to which port will be added (name or ID)

<port>

Port to be added (name or ID)

router add subnet

Add a subnet to a router

os router add subnet
    <router>
    <subnet>
<router>

Router to which subnet will be added (name or ID)

<subnet>

Subnet to be added (name or ID)

router create

Create new router

os router create
    [--project <project> [--project-domain <project-domain>]]
    [--enable | --disable]
    [--distributed]
    [--ha]
    [--description <description>]
    [--availability-zone-hint <availability-zone>]
    <name>
--project <project>

Owner’s project (name or ID)

--project-domain <project-domain>

Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.

--enable

Enable router (default)

--disable

Disable router

--distributed

Create a distributed router

--ha

Create a highly available router

--description <description>

Set router description

--availability-zone-hint <availability-zone>

Availability Zone in which to create this router (Router Availability Zone extension required, repeat option to set multiple availability zones)

<name>

New router name

router delete

Delete router(s)

os router delete
    <router> [<router> ...]
<router>

Router(s) to delete (name or ID)

router list

List routers

os router list
    [--name <name>]
    [--enable | --disable]
    [--long]
    [--project <project> [--project-domain <project-domain>]]
--long

List additional fields in output

--name <name>

List routers according to their name

--enable

List enabled routers

--disable

List disabled routers

--project <project>

List routers according to their project (name or ID)

--project-domain <project-domain>

Domain the project belongs to (name or ID). This can be used in case collisions between project names exist.

router remove port

Remove a port from a router

os router remove port
    <router>
    <port>
<router>

Router from which port will be removed (name or ID)

<port>

Port to be removed and deleted (name or ID)

router remove subnet

Remove a subnet from a router

os router remove subnet
    <router>
    <subnet>
<router>

Router from which subnet will be removed (name or ID)

<subnet>

Subnet to be removed (name or ID)

router set

Set router properties

os router set
    [--name <name>]
    [--enable | --disable]
    [--distributed | --centralized]
    [--description <description>]
    [--route destination=<subnet>,gateway=<ip-address> | --no-route]
    [--ha | --no-ha]
    <router>
--name <name>

Set router name

--enable

Enable router

--disable

Disable router

--distributed

Set router to distributed mode (disabled router only)

--centralized

Set router to centralized mode (disabled router only)

--description <description>

Set router description

--route destination=<subnet>,gateway=<ip-address>

Routes associated with the router destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to set multiple routes)

--no-route

Clear routes associated with the router

--ha

Set the router as highly available (disabled router only)

--no-ha

Clear high availablability attribute of the router (disabled router only)

<router>

Router to modify (name or ID)

router show

Display router details

os router show
    <router>
<router>

Router to display (name or ID)

router unset

Unset router properties

os router unset
    [--route destination=<subnet>,gateway=<ip-address>]
    <router>
--route destination=<subnet>,gateway=<ip-address>

Routes to be removed from the router destination: destination subnet (in CIDR notation) gateway: nexthop IP address (repeat option to unset multiple routes)

<router>

Router to modify (name or ID)