14.3. CD-ROMs Sub-Collection

The cdroms sub-collection represents the CD-ROM device on a virtual machine. A cdroms representation contains the following properties:

Element	Type	Description	Properties
`file id`	string/filename	A reference to an ISO image. See Section 12.2, “ Files Sub-Collection ”

When adding a new CD-ROM, the file id property is required.

Note

Note that a virtual machine may currently only have a single CD-ROM and it is not possible to modify the CD-ROM properties using PUT.

Example 14.6. An XML representation of a CD-ROM device

<cdrom id="00000000-0000-0000-0000-000000000000"
  href="/rhevm-api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/
  00000000-0000-0000-0000-000000000000">
    <file id="en_winxp_pro_with_sp2.iso"/>
    <vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
      href="/rhevm-api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
</cdrom>