32c627eaf0
There are lots of "this option can be repeated" comments in the doc, which are not consistent to other similar docs. This patch changes them to the following format: "repeat option to do something" Change-Id: I54e01053091c428bf87bb36bb95f73a0b80ab6e7
239 lines
3.9 KiB
ReStructuredText
239 lines
3.9 KiB
ReStructuredText
======
|
|
router
|
|
======
|
|
|
|
Network v2
|
|
|
|
router add port
|
|
---------------
|
|
|
|
Add a port to a router
|
|
|
|
.. program:: router add port
|
|
.. code:: bash
|
|
|
|
os router add port
|
|
<router>
|
|
<port>
|
|
|
|
.. _router_add_port:
|
|
|
|
.. describe:: <router>
|
|
|
|
Router to which port will be added (name or ID)
|
|
|
|
.. describe:: <port>
|
|
|
|
Port to be added (name or ID)
|
|
|
|
router add subnet
|
|
-----------------
|
|
|
|
Add a subnet to a router
|
|
|
|
.. program:: router add subnet
|
|
.. code:: bash
|
|
|
|
os router add subnet
|
|
<router>
|
|
<subnet>
|
|
|
|
.. _router_add_subnet:
|
|
|
|
.. describe:: <router>
|
|
|
|
Router to which subnet will be added (name or ID)
|
|
|
|
.. describe:: <subnet>
|
|
|
|
Subnet to be added (name or ID)
|
|
|
|
router create
|
|
-------------
|
|
|
|
Create new router
|
|
|
|
.. program:: router create
|
|
.. code:: bash
|
|
|
|
os router create
|
|
[--project <project> [--project-domain <project-domain>]]
|
|
[--enable | --disable]
|
|
[--distributed]
|
|
[--availability-zone-hint <availability-zone>]
|
|
<name>
|
|
|
|
.. option:: --project <project>
|
|
|
|
Owner's project (name or ID)
|
|
|
|
.. option:: --project-domain <project-domain>
|
|
|
|
Domain the project belongs to (name or ID).
|
|
This can be used in case collisions between project names exist.
|
|
|
|
.. option:: --enable
|
|
|
|
Enable router (default)
|
|
|
|
.. option:: --disable
|
|
|
|
Disable router
|
|
|
|
.. option:: --distributed
|
|
|
|
Create a distributed router
|
|
|
|
.. option:: --availability-zone-hint <availability-zone>
|
|
|
|
Availability Zone in which to create this router
|
|
(requires the Router Availability Zone extension,
|
|
repeat option to set multiple availability zones)
|
|
|
|
.. _router_create-name:
|
|
.. describe:: <name>
|
|
|
|
New router name
|
|
|
|
router delete
|
|
-------------
|
|
|
|
Delete router(s)
|
|
|
|
.. program:: router delete
|
|
.. code:: bash
|
|
|
|
os router delete
|
|
<router> [<router> ...]
|
|
|
|
.. _router_delete-router:
|
|
.. describe:: <router>
|
|
|
|
Router(s) to delete (name or ID)
|
|
|
|
router list
|
|
-----------
|
|
|
|
List routers
|
|
|
|
.. program:: router list
|
|
.. code:: bash
|
|
|
|
os router list
|
|
[--long]
|
|
|
|
.. option:: --long
|
|
|
|
List additional fields in output
|
|
|
|
router remove port
|
|
------------------
|
|
|
|
Remove a port from a router
|
|
|
|
.. program:: router remove port
|
|
.. code:: bash
|
|
|
|
os router remove port
|
|
<router>
|
|
<port>
|
|
|
|
.. _router_remove_port:
|
|
|
|
.. describe:: <router>
|
|
|
|
Router from which port will be removed (name or ID)
|
|
|
|
.. describe:: <port>
|
|
|
|
Port to be removed (name or ID)
|
|
|
|
router remove subnet
|
|
--------------------
|
|
|
|
Remove a subnet from a router
|
|
|
|
.. program:: router remove subnet
|
|
.. code:: bash
|
|
|
|
os router remove subnet
|
|
<router>
|
|
<subnet>
|
|
|
|
.. _router_remove_subnet:
|
|
|
|
.. describe:: <router>
|
|
|
|
Router from which subnet will be removed (name or ID)
|
|
|
|
.. describe:: <subnet>
|
|
|
|
Subnet to be removed (name or ID)
|
|
|
|
router set
|
|
----------
|
|
|
|
Set router properties
|
|
|
|
.. program:: router set
|
|
.. code:: bash
|
|
|
|
os router set
|
|
[--name <name>]
|
|
[--enable | --disable]
|
|
[--distributed | --centralized]
|
|
[--route destination=<subnet>,gateway=<ip-address> | --clear-routes]
|
|
<router>
|
|
|
|
.. option:: --name <name>
|
|
|
|
Set router name
|
|
|
|
.. option:: --enable
|
|
|
|
Enable router
|
|
|
|
.. option:: --disable
|
|
|
|
Disable router
|
|
|
|
.. option:: --distributed
|
|
|
|
Set router to distributed mode (disabled router only)
|
|
|
|
.. option:: --centralized
|
|
|
|
Set router to centralized mode (disabled router only)
|
|
|
|
.. option:: --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)
|
|
|
|
.. option:: --clear-routes
|
|
|
|
Clear routes associated with the router
|
|
|
|
.. _router_set-router:
|
|
.. describe:: <router>
|
|
|
|
Router to modify (name or ID)
|
|
|
|
router show
|
|
-----------
|
|
|
|
Display router details
|
|
|
|
.. program:: router show
|
|
.. code:: bash
|
|
|
|
os router show
|
|
<router>
|
|
|
|
.. _router_show-router:
|
|
.. describe:: <router>
|
|
|
|
Router to display (name or ID)
|