A system administrator can use links in an AdminVdc element to enable, disable, or remove an organization VDC.
Procedure
- To enable a VDC, POST a request to its action/enable link.
- To disable a VDC, POST a request to its action/disable link.
When you disable an organization VDC, you prevent further use of its compute and storage resources. Running vApps and powered on virtual machines continue to run, but you cannot create or start additional vApps or virtual machines.
- To remove a VDC, remove all the objects it contains, then disable and remove it.
- Relocate or remove any vApps that have been deployed in the VDC.
- Remove any organization VDC networks that the VDC contains.
- Remove any Edge Gateways that the VDC contains.
- Disable the VDC by making POST a request to its action/disable link.
After the VDC is disabled, its representation includes a
rel="remove" link if it no longer contains any objects.
- Make a DELETE request to the VDC's rel="remove" link.
Note: You can make a request like this one, which adds the query string
recursive=true
to the VDC href, to remove a VDC that contains one or more objects as long as those objects are in a state that normally allows removal.
DELETE https://vcloud.example.com/api/admin/vdc/44?recursive=true
You can use an additional query parameter to force this kind of recursive removal even when the VDC contains objects that are not in an appropriate state.
DELETE https://vcloud.example.com/api/admin/vdc/44?recursive=true&force=true
Results
The server takes the requested action and returns an HTTP status of 204 No Content.