Class: OvirtSDK4::VmHostDevicesService
- Defined in:
- lib/ovirtsdk4/services.rb,
lib/ovirtsdk4/services.rb
Instance Method Summary collapse
-
#add(device, opts = {}) ⇒ HostDevice
Attach target device to given virtual machine.
-
#device_service(id) ⇒ VmHostDeviceService
Returns a reference to the service that manages a specific host device attached to given virtual machine.
-
#list(opts = {}) ⇒ Array<HostDevice>
List the host devices assigned to given virtual machine.
-
#service(path) ⇒ Service
Locates the service corresponding to the given path.
Methods inherited from Service
Instance Method Details
#add(device, opts = {}) ⇒ HostDevice
Attach target device to given virtual machine.
Example:
POST /ovirt-engine/api/vms/123/hostdevices
With request body of type HostDevice, for example
<host_device id="123" />
Note
|
A necessary precondition for a successful host device attachment is that the virtual machine must be pinned to exactly one host. The device ID is then taken relative to this host. |
Note
|
Attachment of a PCI device that is part of a bigger IOMMU group will result in attachment of the remaining
devices from that IOMMU group as "placeholders". These devices are then identified using the placeholder
attribute of the HostDevice type set to true .
|
In case you want attach a device that already serves as an IOMMU placeholder, simply issue an explicit Add operation
for it, and its placeholder
flag will be cleared, and the device will be accessible to the virtual machine.
30313 30314 30315 |
# File 'lib/ovirtsdk4/services.rb', line 30313 def add(device, opts = {}) internal_add(device, HostDevice, ADD, opts) end |
#device_service(id) ⇒ VmHostDeviceService
Returns a reference to the service that manages a specific host device attached to given virtual machine.
30358 30359 30360 |
# File 'lib/ovirtsdk4/services.rb', line 30358 def device_service(id) VmHostDeviceService.new(self, id) end |
#list(opts = {}) ⇒ Array<HostDevice>
List the host devices assigned to given virtual machine.
The order of the returned list of devices isn’t guaranteed.
30347 30348 30349 |
# File 'lib/ovirtsdk4/services.rb', line 30347 def list(opts = {}) internal_get(LIST, opts) end |
#service(path) ⇒ Service
Locates the service corresponding to the given path.
30369 30370 30371 30372 30373 30374 30375 30376 30377 30378 |
# File 'lib/ovirtsdk4/services.rb', line 30369 def service(path) if path.nil? || path == '' return self end index = path.index('/') if index.nil? return device_service(path) end return device_service(path[0..(index - 1)]).service(path[(index +1)..-1]) end |