Vcenter Iso Image unmount

Vcenter Iso Image unmount

Unmounts a previously mounted CD-ROM using an ISO image as a backing.

Returns an authorization error if you do not have all of the privileges described as follows:

  • Operation execution requires System.Read.
  • The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Config.AddRemoveDevice.
  • The resource com.vmware.vcenter.vm.hardware.Cdrom referenced by the parameter cdrom requires System.Read.
Request
URI
POST
https://{api_host}/api/vcenter/iso/image?action=unmount
COPY
Request Body

Request body for invoking operation: unmount

{
    "vm": "string",
    "cdrom": "string"
}
string
vm
Required

The identifier of the virtual machine from which to unmount the virtual CD-ROM.

The parameter must be an identifier for the resource type: VirtualMachine.

string
cdrom
Required

The device identifier of the CD-ROM.

The parameter must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Cdrom.

Authentication
This operation uses the following authentication methods.
Responses
204

Success!

Operation doesn't return any data structure

400

When the operation is not allowed on the virtual machine in its current state.

Returns Vapi Std Errors NotAllowedInCurrentState of type(s) application/json
This response body class contains all of the following: InlineVapi Std Errors NotAllowedInCurrentState0
{
    "messages": [
        {
            "id": "string",
            "default_message": "string",
            "args": [
                "string"
            ],
            "params": {
                "params": {
                    "s": "string",
                    "dt": "string",
                    "i": 0,
                    "d": "number",
                    "l": "Vapi Std NestedLocalizableMessage Object",
                    "format": "string",
                    "precision": 0
                }
            },
            "localized": "string"
        }
    ],
    "data": {},
    "error_type": "string"
}

404

If the virtual machine identified by vm is not found or the cdrom does not identify a virtual CD-ROM in the virtual machine.

Returns Vapi Std Errors NotFound of type(s) application/json
This response body class contains all of the following: InlineVapi Std Errors NotFound0
"Vapi Std Errors NotFound Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"cdrom:"string","vm:"string"}' https://{api_host}/api/vcenter/iso/image?action=unmount