Interface VmHostDevicesService

  • All Superinterfaces:
    Service
    All Known Implementing Classes:
    VmHostDevicesServiceImpl

    public interface VmHostDevicesService
    extends Service
    A service to manage host devices attached to a virtual machine.
    • Method Detail

      • add

        VmHostDevicesService.AddRequest add()
        Attach target device to given virtual machine. Example: [source] ---- POST /ovirt-engine/api/vms/123/hostdevices ---- With request body of type <>, for example [source,xml] ---- ---- 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 <> 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.
      • list

        VmHostDevicesService.ListRequest list()
        List the host devices assigned to given virtual machine. The order of the returned list of devices isn't guaranteed.
      • deviceService

        VmHostDeviceService deviceService​(String id)
        Returns a reference to the service that manages a specific host device attached to given virtual machine.
      • service

        Service service​(String path)
        Service locator method, returns individual service on which the URI is dispatched.