Verb | URI | Description |
PUT | /routers/router_id /remove_router_interface |
Removes an internal interface from a logical router. |
Normal Response Code: 200
Error Response Codes: Unauthorized (401), Bad Request (400), Not Found (404), Conflict (409)
This request requires a request body.
This request returns a response body.
This operation removes an internal router interface, thus detaching a subnet from the router.
This operation removes an internal router interface, which detaches a subnet from the router. You must specify either a subnet ID or port ID in the request body; this value is used to identify the router interface to remove.
You can also specify both a subnet ID and port ID. If you specify both IDs, the subnet ID must correspond to the subnet ID of the first IP address on the port specified by the port ID. Otherwise, the operation returns a 409 Conflict error. The response contains information about the affected router and interface.
A 404 Not Found error will be returned either if the router or the subnet/port do not exist or are not visible to the user.
As a consequence of this operation, the port connecting the router with the subnet is removed from the subnet's network.
Example 4.24. Remove Router Interface: JSON Request
PUT /v2.0/routers/8604a0de-7f6b-409a-a47c-a1cc7bc77b2e/remove_router_interface Accept: application/json {"subnet_id": "a2f1f29d-571b-4533-907f-5803ab96ead1"}
Example 4.25. Remove Router Interface: Response
{ "id": "8604a0de-7f6b-409a-a47c-a1cc7bc77b2e", "tenant_id": "2f245a7b-796b-4f26-9cf9-9e82d248fda7", "port_id": "3a44f4e5-1694-493a-a1fb-393881c673a4", "subnet_id": "a2f1f29d-571b-4533-907f-5803ab96ead1" }