REST API - info

vcenter vm hardware cdrom: info

The info structure contains information about a virtual CD-ROM device.

Representation:

JSON

{
    "start_connected" : true,
    "backing" : {
        "auto_detect" : true,
        "device_access_type" : "EMULATION",
        "iso_file" : "string",
        "type" : "ISO_FILE",
        "host_device" : "string"
    },
    "allow_guest_control" : true,
    "state" : "CONNECTED",
    "label" : "string",
    "ide" : {
        "primary" : true,
        "master" : true
    },
    "type" : "IDE",
    "sata" : {
        "bus" : 1,
        "unit" : 1
    }
}

Attributes:

Name	Type	Description
Required
type	string	Type of host bus adapter to which the device is attached. Defines the valid types of host bus adapters that may be used for attaching a Cdrom to a virtual machine. Value is one of: IDE: Cdrom is attached to an IDE adapter. SATA: Cdrom is attached to a SATA adapter.
label	string	Device label.
ide.primary	boolean	Flag specifying whether the device is attached to the primary or secondary IDE adapter of the virtual machine.
ide.master	boolean	Flag specifying whether the device is the master or slave device on the IDE adapter.
sata.bus	long	Bus number of the adapter to which the device is attached.
sata.unit	long	Unit number of the device.
backing	backing_info	Physical resource backing for the virtual CD-ROM device.
backing.type	string	Backing type for the virtual CD-ROM device. Defines the valid backing types for a virtual CD-ROM device. Value is one of: ISO_FILE: Virtual CD-ROM device is backed by an ISO file. HOST_DEVICE: Virtual CD-ROM device is backed by a device on the host where the virtual machine is running. CLIENT_DEVICE: Virtual CD-ROM device is backed by a device on the client that is connected to the virtual machine console.
state	string	Connection status of the virtual device. Defines the valid states for a removable device that is configured to be connected. Value is one of: CONNECTED: The device is connected and working correctly. RECOVERABLE_ERROR: Device connection failed due to a recoverable error; for example, the virtual device backing is currently in use by another virtual machine. UNRECOVERABLE_ERROR: Device connection failed due to an unrecoverable error; for example, the virtual device backing does not exist. NOT_CONNECTED: The device is not connected. UNKNOWN: The device status is unknown.
start_connected	boolean	Flag indicating whether the virtual device should be connected whenever the virtual machine is powered on.
allow_guest_control	boolean	Flag indicating whether the guest can connect and disconnect the device.
Optional
ide	ide_address_info	Address of device attached to a virtual IDE adapter. Optional. It is only relevant when type has value IDE. This field is optional and it is only relevant when the value of `type` is IDE.
sata	sata_address_info	Address of device attached to a virtual SATA adapter. Optional. It is only relevant when type has value SATA. This field is optional and it is only relevant when the value of `type` is SATA.
backing.iso_file	string	Path of the image file backing the virtual CD-ROM device. Optional. It is only relevant when type has value ISO_FILE. This field is optional and it is only relevant when the value of `type` is ISO_FILE.
backing.host_device	string	Name of the host device backing the virtual CD-ROM device. Optional. It is only relevant when type has value HOST_DEVICE. This field will be unset if `auto_detect` is true and the virtual CD-ROM device is not connected or no suitable device is available on the host.
backing.auto_detect	boolean	Flag indicating whether the virtual CD-ROM device is configured to automatically detect a suitable host device. Optional. It is only relevant when type has value HOST_DEVICE. This field is optional and it is only relevant when the value of `type` is HOST_DEVICE.
backing.device_access_type	string	Access type for the device backing. Defines the valid device access types for a physical device packing of a virtual CD-ROM device. Value is one of: EMULATION: ATAPI or SCSI device emulation. PASSTHRU: Raw passthru device access. PASSTHRU_EXCLUSIVE: Raw passthru device access, with exclusive access to the device.Optional. It is only relevant when type has value [HOST_DEVICE, CLIENT_DEVICE]. This field is optional and it is only relevant when the value of `type` is one of HOST_DEVICE or CLIENT_DEVICE.