REST API - delete

vcenter vm template library items check outs: delete

Deletes the checked out virtual machine. This operation was added in vSphere API 6.9.1.

Request:

HTTP request

DELETE https://{server}/rest/vcenter/vm-template/library-items/{template_library_item}/check-outs/{vm}

Path Parameters

Name Type Description
Required
template_library_item string Identifier of the VM template library item.
vm string Identifier of the checked out virtual machine to delete.

Response:

HTTP Status Code: 200

None

Errors:

HTTP Status Code Type Description
404 not_found if the library item or virtual machine is not found.
400 invalid_argument if the virtual machine is not checked out of the library item.
400 not_allowed_in_current_state if the virtual machine is running (powered on).
500 resource_busy if the virtual machine is busy performing another operation.
500 resource_inaccessible if the virtual machine's configuration state cannot be accessed.
401 unauthenticated if the user that requested the operation cannot be authenticated.
403 unauthorized if the user that requested the operation is not authorized to perform the operation.
500 error if the system reports an error while responding to the request.