d6d91b666a
Preparation of API-ref cleanup. Part of blueprint neutron-in-tree-api-ref Change-Id: I3d499d60b1687208a2b5882e9f655836c906a297
84 lines
2.0 KiB
ReStructuredText
84 lines
2.0 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:method_verification
|
|
.. needs:parameter_verification
|
|
.. needs:example_verification
|
|
.. needs:body_verification
|
|
|
|
======================
|
|
Extra routes (routers)
|
|
======================
|
|
|
|
Adds extra routes to the ``router`` resource.
|
|
|
|
You can update a router to add a set of next hop IPs and
|
|
destination CIDRs.
|
|
|
|
The next hop IP must be part of a subnet to which the router
|
|
interfaces are connected. You can configure the ``routes``
|
|
attribute on only update operations.
|
|
|
|
Update extra routes
|
|
===================
|
|
|
|
.. rest_method:: PUT /v2.0/routers/{router_id}
|
|
|
|
Updates extra routes on a router.
|
|
|
|
The next hop IP address must be a part of one of the subnets to
|
|
which the router interfaces are connected. Otherwise, the server
|
|
responds with the ``Bad Request (400)`` error code.
|
|
|
|
When a validation error is detected, such as a format error of IP
|
|
address or CIDR, the server responds with the ``Bad Request (400)``
|
|
response code.
|
|
|
|
When Networking receives a request to delete the router interface
|
|
for subnets that are used by one or more routes, it responds with a
|
|
``Conflict (409)`` response code.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: 404,409,401,400
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- external_gateway_info: external_gateway_info
|
|
- destination: destination
|
|
- nexthop: nexthop
|
|
- routes: routes
|
|
- router: router
|
|
- external_fixed_ips: external_fixed_ips
|
|
- router_id: router_id
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: ../samples/routers/router-update-request.json
|
|
:language: javascript
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- external_gateway_info: external_gateway_info
|
|
- status: status
|
|
- enable_snat: enable_snat
|
|
- name: name
|
|
- admin_state_up: admin_state_up
|
|
- tenant_id: tenant_id
|
|
- routes: routes
|
|
- router: router
|
|
- id: id
|
|
- external_fixed_ips: external_fixed_ips
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: ../samples/routers/router-update-response.json
|
|
:language: javascript
|
|
|