Update extra route

Updates logical router with routes attribute.

URI

/v2.0/routers/{router_id}

Description of the URI:

{router_id} UUID The UUID of the router.

HTTP method

PUT

Request parameter

Key Description Type Required/optional
routes Extra route configuration    
nexthop The IP address of the next hop. xsd:string Optional
destination The destination CIDR.

CAUTION:

Do not specify the same CIDR as the one the router interface belongs to.

xsd:string Optional

Example request


{
   "router":{
      "routes":[
         {
            "nexthop":"10.1.0.10",
            "destination":"40.0.1.0/24"
         }
      ]
   }
}
     

Response status

Status code Description
200 Normal response codes
Unauthorized (401) Error response codes
Bad Request (400) Error response codes
Not Found (404) Error response codes
Conflict (409) Error response codes

Response body (normal status)


{"router":
    {"status": "ACTIVE",
     "external_gateway_info": {"network_id": "5c26e0bb-a9a9-429c-9703-5c417a221096"},
     "name": "router1",
     "admin_state_up": true,
     "tenant_id": "936fa220b2c24a87af51026439af7a3e",
     "routes": [{"nexthop": "10.1.0.10", "destination": "40.0.1.0/24"}],
     "id": "babc8173-46f6-4b6f-8b95-38c1683a4e22"},
     "availability_zone": "AZ1"}
}
     

Description of response body (normal status)

Item Description
status The router status.
external_gateway_info The network_id, for the external gateway.
name The router name.
admin_state_up The administrative state of the router, which is up (true) or down (false).
tenant_id The project ID.
routes  
id The router ID.
availability_zone The Availability Zone name.