Deleting virtual routers

DELETE /v2.0/routers/{router_id}

Delete a logical router and, if present, its external gateway interface.

This operation fails if the router has attached internal interfaces. Find their IDs, as explained in Listing virtual router interfaces, and delete them, according to Deleting virtual router interfaces. After deleting all of router’s internal interfaces, delete the router itself.

Source: https://docs.openstack.org/api-ref/network/v2/index.html?expanded=delete-router-detail#delete-router

Request

Parameters

Name In Type Description
router_id path string The ID of the router.

Example

# curl -ks -X DELETE -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:9696/v2.0/routers/ce996632-45a2-4c6b-a951-a624eba74621

Response

Status codes

Success

Code Reason
204 - No Content The server has fulfilled the request.

Error

Code Reason
401 - Unauthorized

User must authenticate before making a request.

404 - Not Found

The requested resource could not be found.

409 - Conflict

This operation conflicted with another operation on this resource.

412 - Precondition Failed

The server does not meet one of the preconditions that the requester put on the request header fields.