vcenter vm hardware cdrom: disconnect
Disconnects a virtual CD-ROM device of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the CD-ROM device is not connected to its backing resource.
For a powered-off virtual machine, the update operation may be used to configure the virtual CD-ROM device to start in the disconnected state when the virtual machine is powered on.
Request:
HTTP request
POST https://{server}/rest/vcenter/vm/{vm}/hardware/cdrom/{cdrom}/disconnect
Path Parameters
| Name | Type | Description |
|---|---|---|
| Required | ||
| vm | string | Virtual machine identifier. |
| cdrom | string | Virtual CD-ROM device identifier. |
Response:
HTTP Status Code: 200
NoneErrors:
| HTTP Status Code | Type | Description |
|---|---|---|
| 500 | error | if the system reports an error while responding to the request. |
| 404 | not_found | if the virtual machine or virtual CD-ROM device is not found. |
| 400 | already_in_desired_state | if the virtual CD-ROM device is already disconnected. |
| 400 | not_allowed_in_current_state | if the virtual machine is not powered on. |
| 400 | resource_busy | if the virtual machine is busy performing another operation. |
| 400 | resource_inaccessible | if the virtual machine's configuration state cannot be accessed. |
| 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. |