REST API - delete

vcenter folder: delete

Delete an empty folder from the vCenter Server. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Request:

HTTP request

DELETE https://{server}/rest/vcenter/folder/{folder}

?force=true

Path Parameters

Name Type Description
Required
folder string Identifier of the folder to be deleted.

Request Query Parameters:

Name Type Description
bold = required
force boolean Optional. If true, delete the folder even if it is not empty.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
500 error if the system reports an error while responding to the request.
404 not_found if there is no folder associated with folder in the system.
400 resource_in_use if the folder associated with folder is not empty.
503 service_unavailable if the system is unable to communicate with a service to complete the request.
401 unauthenticated if the user can not be authenticated.
403 unauthorized if the user doesn't have the required privileges.