Class: OvirtSDK4::VmCdromService
- Defined in:
- lib/ovirtsdk4/services.rb,
lib/ovirtsdk4/services.rb
Instance Method Summary collapse
-
#get(opts = {}) ⇒ Cdrom
Returns the information about this CDROM device.
-
#service(path) ⇒ Service
Locates the service corresponding to the given path.
-
#update(cdrom, opts = {}) ⇒ Cdrom
Updates the information about this CDROM device.
Methods inherited from Service
Instance Method Details
#get(opts = {}) ⇒ Cdrom
Returns the information about this CDROM device.
The information consists of cdrom
attribute containing reference to the CDROM device, the virtual machine,
and optionally the inserted disk.
If there is a disk inserted then the file
attribute will contain a reference to the ISO image:
<cdrom href="..." id="00000000-0000-0000-0000-000000000000">
<file id="mycd.iso"/>
<vm href="/ovirt-engine/api/vms/123" id="123"/>
</cdrom>
If there is no disk inserted then the file
attribute won’t be reported:
<cdrom href="..." id="00000000-0000-0000-0000-000000000000">
<vm href="/ovirt-engine/api/vms/123" id="123"/>
</cdrom>
31854 31855 31856 |
# File 'lib/ovirtsdk4/services.rb', line 31854 def get(opts = {}) internal_get(GET, opts) end |
#service(path) ⇒ Service
Locates the service corresponding to the given path.
31947 31948 31949 31950 31951 31952 |
# File 'lib/ovirtsdk4/services.rb', line 31947 def service(path) if path.nil? || path == '' return self end raise Error.new("The path \"#{path}\" doesn't correspond to any service") end |
#update(cdrom, opts = {}) ⇒ Cdrom
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:
PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000
The body should contain the new value for the file
attribute:
<cdrom>
<file id="mycd.iso"/>
</cdrom>
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
:
<cdrom>
<file id=""/>
</cdrom>
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:
PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000?current=true
With a request body like this:
<cdrom>
<file id=""/>
</cdrom>
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.
|
31936 31937 31938 |
# File 'lib/ovirtsdk4/services.rb', line 31936 def update(cdrom, opts = {}) internal_update(cdrom, Cdrom, UPDATE, opts) end |