Package org.ovirt.engine.sdk4.services

Interface VmCdromService.UpdateRequest

  • All Superinterfaces:
    Request<VmCdromService.UpdateRequest,​VmCdromService.UpdateResponse>
    Enclosing interface:
    VmCdromService
    public static interface VmCdromService.UpdateRequest
extends Request<VmCdromService.UpdateRequest,​VmCdromService.UpdateResponse>
    Updates the information about this CDROM device. It allows to change or eject the disk by changing the value of the `file` attribute. For example, to insert or change the disk send a request like this: [source] ---- PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000 ---- The body should contain the new value for the `file` attribute: [source,xml] ---- ---- The value of the `id` attribute, `mycd.iso` in this example, should correspond to a file available in an attached ISO storage domain. To eject the disk use a `file` with an empty `id`: [source,xml] ---- ---- By default the above operations change permanently the disk that will be visible to the virtual machine after the next boot, but they don't have any effect on the currently running virtual machine. If you want to change the disk that is visible to the current running virtual machine, add the `current=true` parameter. For example, to eject the current disk send a request like this: [source] ---- PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000?current=true ---- With a request body like this: [source,xml] ---- ---- IMPORTANT: The changes made with the `current=true` parameter are never persisted, so they won't have any effect after the virtual machine is rebooted.