Delete Load Balancer

DELETE/v2/lbaas/loadbalancers/{loadbalancer_id}

Deletes the load balancer together with its listeners and pools. The VIP port is removed, so a floating IP associated with it must be moved or released separately.

info

Source: delete-load-balancer

Request

Parameters

loadbalancer_idstringrequiredpath

The ID of the load balancer.

cascadebooleanquery

Delete the load balancer and all of its children. Default behaviour already removes listeners and pools.

Sample Request

curl -ks -X DELETE -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://api.vietnix.cloud:9888/v2/lbaas/loadbalancers/{loadbalancer_id}

Response

Status Code

Success

Status Code	Description
202 - Accepted	The delete was accepted and is being processed.
204 - No Content	The load balancer was deleted.

Error

Status Code	Description
401 - Unauthorized	User must authenticate before making a request.
403 - Forbidden	Policy does not allow current user to do this operation.
404 - Not Found	The load balancer does not exist.
409 - Conflict	The load balancer is in a transient status, for example PENDING_UPDATE.

note

Deleting a load balancer takes a moment. Poll GET /v2/lbaas/loadbalancers/{loadbalancer_id} until it returns 404 before you reuse the VIP address.