ovirt-engine-sdk 4.4.0 → 4.6.0

data/lib/ovirtsdk4/services.rb

@@ -278,6 +278,9 @@ module OvirtSDK4
   class ExternalProviderCertificatesService < Service
   end
   
+  class ExternalTemplateImportsService < Service
+  end
+  
   class ExternalVmImportsService < Service
   end
   
@@ -320,6 +323,9 @@ module OvirtSDK4
   class GroupsService < Service
   end
   
+  class HostCpuUnitsService < Service
+  end
+  
   class HostDeviceService < Service
   end
   
@@ -698,6 +704,12 @@ module OvirtSDK4
   class TemplateGraphicsConsolesService < Service
   end
   
+  class TemplateMediatedDeviceService < Service
+  end
+  
+  class TemplateMediatedDevicesService < Service
+  end
+  
   class TemplateNicService < Service
   end
   
@@ -722,6 +734,12 @@ module OvirtSDK4
   class UserService < Service
   end
   
+  class UserOptionService < Service
+  end
+  
+  class UserOptionsService < Service
+  end
+  
   class UsersService < Service
   end
   
@@ -758,6 +776,18 @@ module OvirtSDK4
   class VmCdromsService < Service
   end
   
+  class VmCheckpointService < Service
+  end
+  
+  class VmCheckpointDiskService < Service
+  end
+  
+  class VmCheckpointDisksService < Service
+  end
+  
+  class VmCheckpointsService < Service
+  end
+  
   class VmDiskService < MeasurableService
   end
   
@@ -776,6 +806,12 @@ module OvirtSDK4
   class VmHostDevicesService < Service
   end
   
+  class VmMediatedDeviceService < Service
+  end
+  
+  class VmMediatedDevicesService < Service
+  end
+  
   class VmNicService < MeasurableService
   end
   
@@ -1312,14 +1348,14 @@ module OvirtSDK4
     end
     
     # 
-    # Access the service that manages the host assignment to this affinity group.
+    # Access the service that manages the host assignment to this affinity group by host id or name.
     # 
-    # @param id [String] The identifier of the `host`.
+    # @param id_or_name [String] The identifier of the `host`.
     # 
     # @return [AffinityGroupHostService] A reference to the `host` service.
     # 
-    def host_service(id)
-      AffinityGroupHostService.new(self, id)
+    def host_service(id_or_name)
+      AffinityGroupHostService.new(self, id_or_name)
     end
     
     # 
@@ -3908,9 +3944,9 @@ module OvirtSDK4
     # Adds or registers a disk.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To add a new disk use the <<services/disks/methods/add, add>>
+    # compatibility. It will be removed in the future. To add a new disk use the xref:services-disks-methods-add[add]
     # operation of the service that manages the disks of the system. To register an unregistered disk use the
-    # <<services/attached_storage_domain_disk/methods/register, register>> operation of the service that manages
+    # xref:services-attached_storage_domain_disk-methods-register[register] operation of the service that manages
     # that disk.
     # 
     # @param disk [Disk] The disk to add or register.
@@ -4853,14 +4889,16 @@ module OvirtSDK4
     
     UPGRADE = [
       [:async, TrueClass].freeze,
+      [:correlation_id, String].freeze,
+      [:upgrade_percent_complete, Integer].freeze,
     ].freeze
     
     private_constant :UPGRADE
     
     # 
-    # Start or finish upgrade process for the cluster based on the action value. This action marks the cluster for
-    # upgrade or clears the upgrade running flag on the cluster based on the action value which takes values of
-    # start or stop.
+    # Start, update or finish upgrade process for the cluster based on the action value. This action marks the
+    # cluster for upgrade, updates the progress, or clears the upgrade running flag on the cluster based on the
+    # action value which takes values of `start`, `stop` or `update_progress`.
     # 
     # [source]
     # ----
@@ -4878,12 +4916,32 @@ module OvirtSDK4
     # </action>
     # ----
     # 
+    # After starting the upgrade, use a request body like this to update the progress to 15%:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <upgrade_action>
+    #         update_progress
+    #     </upgrade_action>
+    #     <upgrade_percent_complete>
+    #         15
+    #     </upgrade_percent_complete>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
+    # @option opts [String] :correlation_id Explicitly set the upgrade correlation identifier.  Use to correlate events
+    #   detailing the cluster upgrade to the upgrade itself.  If not specificed, the
+    #   correlation id from `Correlation-Id` http header will be used.
+    # 
     # @option opts [ClusterUpgradeAction] :upgrade_action The action to be performed.
     # 
+    # @option opts [Integer] :upgrade_percent_complete Update the upgrade's progress as a percent complete of the total process.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -5066,7 +5124,7 @@ module OvirtSDK4
     # GET /ovirt-engine/api/clusters/123/enabledfeatures/456
     # ----
     # 
-    # That will return a <<types/cluster_feature, ClusterFeature>> object containing the name:
+    # That will return a xref:types-cluster_feature[ClusterFeature] object containing the name:
     # 
     # [source,xml]
     # ----
@@ -5331,7 +5389,7 @@ module OvirtSDK4
     # GET /ovirt-engine/api/clusterlevels/4.1/clusterfeatures/456
     # ----
     # 
-    # That will return a <<types/cluster_feature, ClusterFeature>> object containing the name:
+    # That will return a xref:types-cluster_feature[ClusterFeature] object containing the name:
     # 
     # [source,xml]
     # ----
@@ -5473,7 +5531,7 @@ module OvirtSDK4
     # GET /ovirt-engine/api/clusterlevels/3.6
     # ----
     # 
-    # That will return a <<types/cluster_level, ClusterLevel>> object containing the supported CPU types, and other
+    # That will return a xref:types-cluster_level[ClusterLevel] object containing the supported CPU types, and other
     # information which describes the cluster level:
     # 
     # [source,xml]
@@ -6240,6 +6298,48 @@ module OvirtSDK4
   
   class DataCenterService < Service
     
+    CLEAN_FINISHED_TASKS = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :CLEAN_FINISHED_TASKS
+    
+    # 
+    # Currently, the storage pool manager (SPM) fails to
+    # switch to another host if the SPM has uncleared tasks.
+    # Clearing all finished tasks enables the SPM switching.
+    # 
+    # For example, to clean all the finished tasks on a data center with ID `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/cleanfinishedtasks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def clean_finished_tasks(opts = {})
+      internal_action(:cleanfinishedtasks, nil, CLEAN_FINISHED_TASKS, opts)
+    end
+    
     GET = [
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
@@ -6352,6 +6452,53 @@ module OvirtSDK4
       internal_remove(REMOVE, opts)
     end
     
+    SET_MASTER = [
+      [:async, TrueClass].freeze,
+      [:storage_domain, StorageDomain].freeze,
+    ].freeze
+    
+    private_constant :SET_MASTER
+    
+    # 
+    # Used for manually setting a storage domain in the data center as a master.
+    # For example, for setting a storage domain with ID '456' as a master on a data center with ID '123',
+    # send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/setmaster
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain id="456"/>
+    # </action>
+    # ----
+    # 
+    # The new master storage domain can be also specified by its name.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
+    # 
+    # @option opts [StorageDomain] :storage_domain The new master storage domain for the data center.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def set_master(opts = {})
+      internal_action(:setmaster, nil, SET_MASTER, opts)
+    end
+    
     UPDATE = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -7119,7 +7266,7 @@ module OvirtSDK4
     # POST /ovirt-engine/api/vms/345/diskattachments
     # ----
     # 
-    # IMPORTANT: The server accepts requests that don't contain the `active` attribute, but the effect is
+    # IMPORTANT: The server accepts requests that do not contain the `active` attribute, but the effect is
     # undefined. In some cases the disk will be automatically activated and in other cases it won't. To
     # avoid issues it is strongly recommended to always include the `active` attribute with the desired
     # value.
@@ -7545,6 +7692,8 @@ module OvirtSDK4
     
     LIST = [
       [:follow, String].freeze,
+      [:include_active, TrueClass].freeze,
+      [:include_template, TrueClass].freeze,
       [:max, Integer].freeze,
     ].freeze
     
@@ -7560,6 +7709,10 @@ module OvirtSDK4
     # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
     #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
     # 
+    # @option opts [Boolean] :include_active If true return also active snapshots. If not specified active snapshots are not returned.
+    # 
+    # @option opts [Boolean] :include_template If true return also template snapshots. If not specified template snapshots are not returned.
+    # 
     # @option opts [Integer] :max Sets the maximum number of snapshots to return. If not specified all the snapshots are returned.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -7618,20 +7771,20 @@ module OvirtSDK4
     # 
     # Adds a new floating disk.
     # 
-    # There are three types of disks that can be added - disk image, direct LUN and
-    #  https://wiki.openstack.org/wiki/Cinder[Cinder] disk.
+    # There are three types of disks that can be added - disk image, direct LUN and Managed Block disk.
+    # link:https://wiki.openstack.org/wiki/Cinder[Cinder] integration has been replaced by Managed Block Storage.
     # 
     # *Adding a new image disk:*
     # 
-    # When creating a new floating image <<types/disk,Disk>>, the API requires the `storage_domain`, `provisioned_size`
+    # When creating a new floating image xref:types-disk[Disk], the API requires the `storage_domain`, `provisioned_size`
     # and `format` attributes.
     # 
-    # Note that block storage domains (i.e., storage domains with the <<types/storage_type, storage type>> of iSCSI or
-    # FCP) don't support the combination of the raw `format` with `sparse=true`, so `sparse=false` must be stated
+    # Note that block storage domains (i.e. storage domains with the xref:types-storage_type[storage type] of iSCSI or
+    # FCP) do not support the combination of the raw `format` with `sparse=true`, so `sparse=false` must be stated
     # explicitly.
     # 
     # To create a new floating image disk with specified `provisioned_size`, `format` and `name` on a storage domain
-    # with an id `123`, send a request as follows:
+    # with an id `123` and enabled for incremental backup, send a request as follows:
     # 
     # [source]
     # ----
@@ -7649,6 +7802,7 @@ module OvirtSDK4
     #   <name>mydisk</name>
     #   <provisioned_size>1048576</provisioned_size>
     #   <format>cow</format>
+    #   <backup>incremental</backup>
     # </disk>
     # ----
     # 
@@ -7696,32 +7850,8 @@ module OvirtSDK4
     # 
     # *Adding a new Cinder disk:*
     # 
-    # To create a new floating Cinder disk, send a request as follows:
-    # 
-    # [source]
-    # ----
-    # POST /ovirt-engine/api/disks
-    # ----
-    # 
-    # With a request body as follows:
-    # 
-    # [source,xml]
-    # ----
-    # <disk>
-    #   <openstack_volume_type>
-    #     <name>myceph</name>
-    #   </openstack_volume_type>
-    #   <storage_domains>
-    #     <storage_domain>
-    #       <name>cinderDomain</name>
-    #     </storage_domain>
-    #   </storage_domains>
-    #   <provisioned_size>1073741824</provisioned_size>
-    #   <interface>virtio</interface>
-    #   <format>raw</format>
-    # </disk>
-    # ----
-    # 
+    # Cinder integration has been replaced by Managed Block Storage.
+    # //TODO: Add an example for adding an MBS disk
     # 
     # *Adding a floating disks in order to upload disk snapshots:*
     # 
@@ -10138,6 +10268,73 @@ module OvirtSDK4
     
   end
   
+  class ExternalTemplateImportsService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # This operation is used to import a template from external hypervisor.
+    # 
+    # For example import of a template OVA can be facilitated using the following request:
+    # 
+    # [source]
+    # ----
+    # POST /externaltemplateimports
+    # ----
+    # 
+    # With request body of type xref:types-external_template_import[ExternalTemplateImport], for example:
+    # 
+    # [source,xml]
+    # ----
+    # <external_template_import>
+    #   <template>
+    #     <name>my_template</name>
+    #   </template>
+    #   <cluster id="2b18aca2-4469-11eb-9449-482ae35a5f83" />
+    #   <storage_domain id="8bb5ade5-e988-4000-8b93-dbfc6717fe50" />
+    #   <url>ova:///mnt/ova/ova_template.ova</url>
+    #   <host id="8bb5ade5-e988-4000-8b93-dbfc6717fe50" />
+    # </external_template_import>
+    # ----
+    # 
+    # @param import [ExternalTemplateImport] The `import` to add.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [ExternalTemplateImport]
+    # 
+    def add(import, opts = {})
+      internal_add(import, ExternalTemplateImport, ADD, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
   class ExternalVmImportsService < Service
     
     ADD = [
@@ -10155,7 +10352,7 @@ module OvirtSDK4
     # POST /externalvmimports
     # ----
     # 
-    # With request body of type <<types/external_vm_import,ExternalVmImport>>, for example:
+    # With request body of type xref:types-external_vm_import[ExternalVmImport], for example:
     # 
     # [source,xml]
     # ----
@@ -11034,8 +11231,8 @@ module OvirtSDK4
     # 
     # Removing bricks is a two-step process, where the data on bricks to be removed, is first migrated to remaining
     # bricks. Once migration is completed the removal of bricks is confirmed via the API
-    # <<services/gluster_bricks/methods/remove, remove>>. If at any point, the action needs to be cancelled
-    # <<services/gluster_bricks/methods/stop_migrate, stopmigrate>> has to be called.
+    # xref:services-gluster_bricks-methods-remove[remove]. If at any point, the action needs to be cancelled
+    # xref:services-gluster_bricks-methods-stop_migrate[stopmigrate] has to be called.
     # 
     # For instance, to delete a brick from a gluster volume with id `123`, send a request:
     # 
@@ -11058,7 +11255,7 @@ module OvirtSDK4
     # ----
     # 
     # The migration process can be tracked from the job id returned from the API using
-    # <<services/job/methods/get, job>> and steps in job using <<services/step/methods/get, step>>
+    # xref:services-job-methods-get[job] and steps in job using xref:services-step-methods-get[step]
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11091,7 +11288,7 @@ module OvirtSDK4
     # Removes bricks from gluster volume.
     # 
     # The recommended way to remove bricks without data loss is to first migrate the data using
-    # <<services/gluster_bricks/methods/stop_migrate, stopmigrate>> and then removing them. If migrate was not called on
+    # xref:services-gluster_bricks-methods-stop_migrate[stopmigrate] and then removing them. If migrate was not called on
     # bricks prior to remove, the bricks are removed without data migration which may lead to data loss.
     # 
     # For example, to delete the bricks from gluster volume `123`, send a request like this:
@@ -11167,7 +11364,7 @@ module OvirtSDK4
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
     # @option opts [Array<GlusterBrick>] :bricks List of bricks for which data migration needs to be stopped. This list should match the arguments passed to
-    #   <<services/gluster_bricks/methods/migrate, migrate>>.
+    #   xref:services-gluster_bricks-methods-migrate[migrate].
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -11886,6 +12083,55 @@ module OvirtSDK4
     
   end
   
+  class HostCpuUnitsService < Service
+    
+    LIST = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Returns the List of all host's CPUs with detailed information
+    # about the topology (socket, core) and with information
+    # about the current CPU pinning.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<HostCpuUnit>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
   class HostDeviceService < Service
     
     GET = [
@@ -12421,6 +12667,7 @@ module OvirtSDK4
     ADD = [
       [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
+      [:reboot, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
     
@@ -12504,6 +12751,8 @@ module OvirtSDK4
     #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
     #   the host performs no operation in the hosted engine area.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
     #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
     #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
@@ -12636,6 +12885,7 @@ module OvirtSDK4
     ADD_USING_ROOT_PASSWORD = [
       [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
+      [:reboot, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
     
@@ -12657,6 +12907,8 @@ module OvirtSDK4
     #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
     #   the host performs no operation in the hosted engine area.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
     #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
     #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
@@ -12679,13 +12931,14 @@ module OvirtSDK4
     ADD_USING_SSH = [
       [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
+      [:reboot, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_USING_SSH
     
     # 
-    # Add a new host to the system providing the ssh password or fingerprint.
+    # Add a new host to the system providing the ssh password, fingerprint or public key.
     # 
     # @param host [Host] The host definition with which the new host is created is passed as a parameter, and the newly created host
     #   is returned.
@@ -12700,6 +12953,8 @@ module OvirtSDK4
     #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
     #   the host performs no operation in the hosted engine area.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
     #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
     #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
@@ -15366,6 +15621,15 @@ module OvirtSDK4
       internal_update(pool, MacPool, UPDATE, opts)
     end
     
+    # 
+    # Returns a reference to the service that manages the permissions that are associated with the MacPool.
+    # 
+    # @return [AssignedPermissionsService] A reference to `permissions` service.
+    # 
+    def permissions_service
+      @permissions_service ||= AssignedPermissionsService.new(self, 'permissions')
+    end
+    
     # 
     # Locates the service corresponding to the given path.
     # 
@@ -15377,6 +15641,12 @@ module OvirtSDK4
       if path.nil? || path == ''
         return self
       end
+      if path == 'permissions'
+        return permissions_service
+      end
+      if path.start_with?('permissions/')
+        return permissions_service.service(path[12..-1])
+      end
       raise Error.new("The path \"#{path}\" doesn't correspond to any service")
     end
     
@@ -15665,9 +15935,9 @@ module OvirtSDK4
     # ----
     # 
     # NOTE: To remove an external logical network, the network has to be removed directly from its provider by
-    # https://developer.openstack.org/api-ref/network[OpenStack Networking API].
+    # link:https://developer.openstack.org/api-ref/network[OpenStack Networking API].
     # The entity representing the external network inside {product-name} is removed automatically,
-    # if <<types/open_stack_network_provider/attributes/auto_sync,`auto_sync`>> is enabled for the provider,
+    # if xref:types-open_stack_network_provider-attributes-auto_sync[`auto_sync`] is enabled for the provider,
     # otherwise the entity has to be removed using this method.
     # 
     # @param opts [Hash] Additional options.
@@ -17243,7 +17513,7 @@ module OvirtSDK4
     #   using the `id` or `name` attributes. The rest of
     #   the attributes will be ignored.
     #   
-    #   NOTE: If <<types/open_stack_network_provider/attributes/auto_sync,`auto_sync`>> is
+    #   NOTE: If xref:types-open_stack_network_provider-attributes-auto_sync[`auto_sync`] is
     #   enabled for the provider, the network might be imported automatically. To
     #   prevent this, automatic import can be disabled by setting the `auto_sync` to false,
     #   and enabling it again after importing the network.
@@ -18771,7 +19041,7 @@ module OvirtSDK4
     private_constant :ADD
     
     # 
-    # Adds a permit to the role. The permit name can be retrieved from the <<services/cluster_levels>> service.
+    # Adds a permit to the role. The permit name can be retrieved from the xref:services-cluster_levels[cluster_levels] service.
     # 
     # For example to assign a permit `create_vm` to the role with id `123` send a request like this:
     # 
@@ -19931,7 +20201,7 @@ module OvirtSDK4
     # 
     # Updates a role. You are allowed to update `name`, `description` and `administrative` attributes after role is
     # created. Within this endpoint you can't add or remove roles permits you need to use
-    # <<services/permits, service>> that manages permits of role.
+    # xref:services-permits[service] that manages permits of role.
     # 
     # For example to update role's `name`, `description` and `administrative` attributes send a request like this:
     # 
@@ -20623,6 +20893,7 @@ module OvirtSDK4
     # ----
     # <action/>
     # ----
+    # NOTE: Confirm that the commit operation is finished and the virtual machine is down before running the virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -21124,8 +21395,8 @@ module OvirtSDK4
     # 
     # [IMPORTANT]
     # ====
-    # When a snapshot is created the default value for the <<types/snapshot/attributes/persist_memorystate,
-    # persist_memorystate>> attribute is `true`. That means that the content of the memory of the virtual
+    # When a snapshot is created, the default value for the
+    # xref:types-snapshot-attributes-persist_memorystate[persist_memorystate] attribute is `true`. That means that the content of the memory of the virtual
     # machine will be included in the snapshot, and it also means that the virtual machine will be paused
     # for a longer time. That can negatively affect applications that are very sensitive to timing (NTP
     # servers, for example). In those cases make sure that you set the attribute to `false`:
@@ -21298,7 +21569,10 @@ module OvirtSDK4
     private_constant :UPDATE
     
     # 
-    # Updates the `key`.
+    # Replaces the key with a new resource.
+    # 
+    # IMPORTANT: Since version 4.4.8 of the engine this operation is deprecated, and preserved only for backwards
+    # compatibility. It will be removed in the future. Instead please use DELETE followed by xref:services-ssh_public_keys-methods-add[add operation].
     # 
     # @param key [SshPublicKey] The `key` to update.
     # @param opts [Hash] Additional options.
@@ -22134,7 +22408,7 @@ module OvirtSDK4
     # ----
     # 
     #  Note that this operation is only applicable to block storage domains (i.e., storage domains with the
-    #  <<types/storage_type, storage type> of iSCSI or FCP).
+    #  xref:types-storage_type[storage type] of iSCSI or FCP).
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -22284,7 +22558,7 @@ module OvirtSDK4
     # 
     # Updates a storage domain.
     # 
-    # Not all of the <<types/storage_domain,StorageDomain>>'s attributes are updatable after creation. Those that can be
+    # Not all of the xref:types-storage_domain[StorageDomain]'s attributes are updatable after creation. Those that can be
     # updated are: `name`, `description`, `comment`, `warning_low_space_indicator`, `critical_space_action_blocker` and
     # `wipe_after_delete.` (Note that changing the `wipe_after_delete` attribute will not change the wipe after delete
     # property of disks that already exist).
@@ -22658,7 +22932,7 @@ module OvirtSDK4
     # Copies a disk to the specified storage domain.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To copy a disk use the <<services/disk/methods/copy, copy>>
+    # compatibility. It will be removed in the future. To copy a disk use the xref:services-disk-methods-copy[copy]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -22690,7 +22964,7 @@ module OvirtSDK4
     # Exports a disk to an export storage domain.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To export a disk use the <<services/disk/methods/export, export>>
+    # compatibility. It will be removed in the future. To export a disk use the xref:services-disk-methods-export[export]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -22751,7 +23025,7 @@ module OvirtSDK4
     # Moves a disk to another storage domain.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To move a disk use the <<services/disk/methods/move, move>>
+    # compatibility. It will be removed in the future. To move a disk use the xref:services-disk-methods-move[move]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -22814,7 +23088,7 @@ module OvirtSDK4
     # Removes a disk.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To remove a disk use the <<services/disk/methods/remove, remove>>
+    # compatibility. It will be removed in the future. To remove a disk use the xref:services-disk-methods-remove[remove]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -22841,7 +23115,7 @@ module OvirtSDK4
     # Sparsify the disk.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To remove a disk use the <<services/disk/methods/remove, remove>>
+    # compatibility. It will be removed in the future. To remove a disk use the xref:services-disk-methods-remove[remove]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -22869,7 +23143,7 @@ module OvirtSDK4
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
     # compatibility. It will be removed in the future. To update a disk use the
-    # <<services/disk/methods/update, update>> operation of the service that manages that disk.
+    # xref:services-disk-methods-update[update] operation of the service that manages that disk.
     # 
     # @param disk [Disk] The update to apply to the disk.
     # @param opts [Hash] Additional options.
@@ -22947,9 +23221,9 @@ module OvirtSDK4
     # Adds or registers a disk.
     # 
     # IMPORTANT: Since version 4.2 of the {engine-name} this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To add a new disk use the <<services/disks/methods/add, add>>
+    # compatibility. It will be removed in the future. To add a new disk use the xref:services-disks-methods-add[add]
     # operation of the service that manages the disks of the system. To register an unregistered disk use the
-    # <<services/attached_storage_domain_disk/methods/register, register>> operation of the service that manages
+    # xref:services-attached_storage_domain_disk-methods-register[register] operation of the service that manages
     # that disk.
     # 
     # @param disk [Disk] The disk to add or register.
@@ -23402,7 +23676,7 @@ module OvirtSDK4
     #   
     #   WARNING: Please note that this attribute has been deprecated since version 4.2.1 of the engine, and preserved only for backward
     #   compatibility. It will be removed in the future. To specify `vnic_profile_mappings` use the `vnic_profile_mappings`
-    #   attribute inside the <<types/registration_configuration, RegistrationConfiguration>> type.
+    #   attribute inside the xref:types-registration_configuration[RegistrationConfiguration] type.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -23752,7 +24026,7 @@ module OvirtSDK4
     #   
     #   WARNING: Please note that this attribute has been deprecated since version 4.2.1 of the engine, and preserved only for backward
     #   compatibility. It will be removed in the future. To specify `vnic_profile_mappings` use the `vnic_profile_mappings`
-    #   attribute inside the <<types/registration_configuration, RegistrationConfiguration>> type.
+    #   attribute inside the xref:types-registration_configuration[RegistrationConfiguration] type.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -24047,7 +24321,7 @@ module OvirtSDK4
     # 
     # Adds a new storage domain.
     # 
-    # Creation of a new <<types/storage_domain,StorageDomain>> requires the `name`, `type`, `host`, and `storage`
+    # Creation of a new xref:types-storage_domain[StorageDomain] requires the `name`, `type`, `host`, and `storage`
     # attributes. Identify the `host` attribute with the `id` or `name` attributes. In {product-name} 3.6 and
     # later you can enable the wipe after delete option by default on the storage domain. To configure this, specify
     # `wipe_after_delete` in the POST request. This option can be edited after the domain is created, but doing so will
@@ -25395,6 +25669,15 @@ module OvirtSDK4
       @external_host_providers_service ||= ExternalHostProvidersService.new(self, 'externalhostproviders')
     end
     
+    # 
+    # Reference to service facilitating import of external templates.
+    # 
+    # @return [ExternalTemplateImportsService] A reference to `external_template_imports` service.
+    # 
+    def external_template_imports_service
+      @external_template_imports_service ||= ExternalTemplateImportsService.new(self, 'externaltemplateimports')
+    end
+    
     # 
     # Reference to service facilitating import of external virtual machines.
     # 
@@ -25725,6 +26008,12 @@ module OvirtSDK4
       if path.start_with?('externalhostproviders/')
         return external_host_providers_service.service(path[22..-1])
       end
+      if path == 'externaltemplateimports'
+        return external_template_imports_service
+      end
+      if path.start_with?('externaltemplateimports/')
+        return external_template_imports_service.service(path[24..-1])
+      end
       if path == 'externalvmimports'
         return external_vm_imports_service
       end
@@ -25909,37 +26198,46 @@ module OvirtSDK4
     # 
     # Get the values of specific configuration option.
     # 
-    # For example to retrieve the values of configuration option `MigrationPoliciesSupported` send a request like this:
+    # For example to retrieve the values of configuration option `MigrationPolicies` send a request like this:
     # 
     # [source]
     # ----
-    # GET /ovirt-engine/api/options/MigrationPoliciesSupported
+    # GET /ovirt-engine/api/options/MigrationPolicies
     # ----
     # 
     # The response to that request will be the following:
     # 
     # [source,xml]
     # ----
-    # <system_option href="/ovirt-engine/api/options/MigrationPoliciesSupported" id="MigrationPoliciesSupported">
-    #   <name>MigrationPoliciesSupported</name>
-    #   <values>
-    #     <system_option_value>
-    #       <value>true</value>
-    #       <version>4.0</version>
-    #     </system_option_value>
-    #     <system_option_value>
-    #       <value>true</value>
-    #       <version>4.1</version>
-    #     </system_option_value>
-    #     <system_option_value>
-    #       <value>true</value>
-    #       <version>4.2</version>
-    #     </system_option_value>
-    #     <system_option_value>
-    #       <value>false</value>
-    #       <version>3.6</version>
-    #     </system_option_value>
-    #   </values>
+    # <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+    # <system_option href="/ovirt-engine/api/options/MigrationPolicies" id="MigrationPolicies">
+    #     <name>MigrationPolicies</name>
+    #     <values>
+    #         <system_option_value>
+    #             <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #             <version>4.2</version>
+    #         </system_option_value>
+    #         <system_option_value>
+    #             <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #             <version>4.3</version>
+    #         </system_option_value>
+    #         <system_option_value>
+    #             <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #             <version>4.4</version>
+    #         </system_option_value>
+    #         <system_option_value>
+    #             <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #             <version>4.5</version>
+    #         </system_option_value>
+    #         <system_option_value>
+    #             <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #             <version>4.6</version>
+    #         </system_option_value>
+    #         <system_option_value>
+    #             <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #             <version>4.7</version>
+    #         </system_option_value>
+    #     </values>
     # </system_option>
     # ----
     # 
@@ -25962,26 +26260,26 @@ module OvirtSDK4
     #   should be returned.
     #   If this parameter isn't used then all the versions will be returned.
     #   
-    #   For example, to get the value of the `MigrationPoliciesSupported` option but only for version `4.2` send
+    #   For example, to get the value of the `MigrationPolicies` option but only for version `4.2` send
     #   a request like this:
     #   
     #   [source]
     #   ----
-    #   GET /ovirt-engine/api/options/MigrationPoliciesSupported?version=4.2
+    #   GET /ovirt-engine/api/options/MigrationPolicies?version=4.2
     #   ----
     #   
     #   The response to that request will be like this:
     #   
     #   [source,xml]
     #   ----
-    #   <system_option href="/ovirt-engine/api/options/MigrationPoliciesSupported" id="MigrationPoliciesSupported">
-    #     <name>MigrationPoliciesSupported</name>
-    #     <values>
-    #       <system_option_value>
-    #         <value>true</value>
-    #         <version>4.2</version>
-    #       </system_option_value>
-    #     </values>
+    #   <system_option href="/ovirt-engine/api/options/MigrationPolicies" id="MigrationPolicies">
+    #       <name>MigrationPolicies</name>
+    #       <values>
+    #           <system_option_value>
+    #               <value>[{"id":{"uuid":"80554327-0569-496b-bdeb-fcbbf52b827b"},...}]</value>
+    #               <version>4.2</version>
+    #           </system_option_value>
+    #       </values>
     #   </system_option>
     #   ----
     # 
@@ -26797,6 +27095,27 @@ module OvirtSDK4
     # </action>
     # ----
     # 
+    # Since version 4.2 of the engine it is also possible to export a template as a virtual appliance (OVA).
+    # For example, to export template `123` as an OVA file named `myvm.ova` that is placed in the directory `/home/ovirt/` on host `myhost`:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/templates/123/export
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <host>
+    #     <name>myhost</name>
+    #   </host>
+    #   <directory>/home/ovirt</directory>
+    #   <filename>myvm.ova</filename>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :exclusive Indicates if the existing templates with the same name should be overwritten.
@@ -27045,6 +27364,15 @@ module OvirtSDK4
       @graphics_consoles_service ||= TemplateGraphicsConsolesService.new(self, 'graphicsconsoles')
     end
     
+    # 
+    # Reference to the service that manages mediated devices associated with the template.
+    # 
+    # @return [TemplateMediatedDevicesService] A reference to `mediated_devices` service.
+    # 
+    def mediated_devices_service
+      @mediated_devices_service ||= TemplateMediatedDevicesService.new(self, 'mediateddevices')
+    end
+    
     # 
     # Returns a reference to the service that manages the NICs that are associated with the template.
     # 
@@ -27110,6 +27438,12 @@ module OvirtSDK4
       if path.start_with?('graphicsconsoles/')
         return graphics_consoles_service.service(path[17..-1])
       end
+      if path == 'mediateddevices'
+        return mediated_devices_service
+      end
+      if path.start_with?('mediateddevices/')
+        return mediated_devices_service.service(path[16..-1])
+      end
       if path == 'nics'
         return nics_service
       end
@@ -27776,6 +28110,238 @@ module OvirtSDK4
     
   end
   
+  class TemplateMediatedDeviceService < Service
+    
+    GET = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Gets mediated device configuration of the template.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [VmMediatedDevice]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    REMOVE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Remove the mediated device from the template.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def remove(opts = {})
+      internal_remove(REMOVE, opts)
+    end
+    
+    UPDATE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :UPDATE
+    
+    # 
+    # Updates the information about the mediated device.
+    # 
+    # You can update the information using `specParams` element.
+    # 
+    # For example, to update a mediated device, send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/templates/123/mediateddevices/00000000-0000-0000-0000-000000000000
+    # <vm_mediated_device>
+    #   <spec_params>
+    #     <property>
+    #       <name>mdevType</name>
+    #       <value>nvidia-11</value>
+    #     </property>
+    #   </spec_params>
+    # </vm_mediated_device>
+    # ----
+    # 
+    # with response body:
+    # 
+    # [source,xml]
+    # ----
+    # <vm_mediated_device href="/ovirt-engine/api/templates/123/mediateddevices/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000">
+    #   <template href="/ovirt-engine/api/templates/123" id="123"/>
+    #   <spec_params>
+    #     <property>
+    #       <name>mdevType</name>
+    #       <value>nvidia-11</value>
+    #     </property>
+    #   </spec_params>
+    # </vm_mediated_device>
+    # ----
+    # 
+    # @param devices [VmMediatedDevice] The information about the mediated device.
+    #   
+    #   The request data must contain `specParams` properties.
+    #   The response data contains complete information about the
+    #   updated mediated device.
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [VmMediatedDevice]
+    # 
+    def update(devices, opts = {})
+      internal_update(devices, VmMediatedDevice, UPDATE, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class TemplateMediatedDevicesService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Add new mediated device to the template.
+    # 
+    # @param device [VmMediatedDevice] The `device` to add.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [VmMediatedDevice]
+    # 
+    def add(device, opts = {})
+      internal_add(device, VmMediatedDevice, ADD, opts)
+    end
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Lists all the configured mediated devices of the template.
+    # 
+    # The order of the returned list of mediated devices isn't guaranteed.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of mediated devices to return.
+    #   If not specified all the mediated devices are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<VmMediatedDevice>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Returns a reference to the service that manages a mediated device of a template.
+    # 
+    # @param id [String] The identifier of the `device`.
+    # 
+    # @return [TemplateMediatedDeviceService] A reference to the `device` service.
+    # 
+    def device_service(id)
+      TemplateMediatedDeviceService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    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
+    
+  end
+  
   class TemplateNicService < Service
     
     GET = [
@@ -28215,7 +28781,7 @@ module OvirtSDK4
     # original virtual machine. To do so use the `vm.disk_attachments` attribute, specifying the identifier of the disk
     # of the original virtual machine and the characteristics that you want to change. For example, if the original
     # virtual machine has a disk with the identifier `456`, and, for that disk, you want to change the name to `mydisk`
-    # the format to <<types/disk_format, _Copy On Write_>> and make it <<types/disk, sparse>>, send a request body like
+    # the format to xref:types-disk_format[_Copy On Write_] and make it xref:types-disk[sparse], send a request body like
     # this:
     # 
     # [source,xml]
@@ -28885,12 +29451,16 @@ module OvirtSDK4
     #    <user_options>
     #       <property>
     #          <name>test</name>
-    #          <value>test1</value>
+    #          <value>["any","JSON"]</value>
     #       </property>
     #    </user_options>
     # </user>
     # ----
     # 
+    # IMPORTANT: Since version 4.4.5 of the engine this operation is deprecated, and preserved only for backwards
+    # compatibility. It will be removed in the future. Please use the xref:services-user_option[options]
+    # endpoint instead.
+    # 
     # @param user [User] The `user` to update.
     # @param opts [Hash] Additional options.
     # 
@@ -28927,6 +29497,15 @@ module OvirtSDK4
       @groups_service ||= DomainUserGroupsService.new(self, 'groups')
     end
     
+    # 
+    # Locates the `options` service.
+    # 
+    # @return [UserOptionsService] A reference to `options` service.
+    # 
+    def options_service
+      @options_service ||= UserOptionsService.new(self, 'options')
+    end
+    
     # 
     # Locates the `permissions` service.
     # 
@@ -28986,6 +29565,12 @@ module OvirtSDK4
       if path.start_with?('groups/')
         return groups_service.service(path[7..-1])
       end
+      if path == 'options'
+        return options_service
+      end
+      if path.start_with?('options/')
+        return options_service.service(path[8..-1])
+      end
       if path == 'permissions'
         return permissions_service
       end
@@ -29015,6 +29600,219 @@ module OvirtSDK4
     
   end
   
+  class UserOptionService < Service
+    
+    GET = [
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Returns a user profile property of type JSON.
+    # 
+    # Example request(for user with identifier `123` and option with identifier `456`):
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/users/123/options/456
+    # ----
+    # 
+    # The result will be the following XML document:
+    # 
+    # [source,xml]
+    # ----
+    #   <user_option href="/ovirt-engine/api/users/123/options/456" id="456">
+    #     <name>SomeName</name>
+    #     <content>["any", "JSON"]</content>
+    #     <user href="/ovirt-engine/api/users/123" id="123"/>
+    #   </user_option>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [UserOption]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    REMOVE = [
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Deletes an existing property of type JSON.
+    # 
+    # Example request(for user with identifier `123` and option with identifier `456`):
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/users/123/options/456
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def remove(opts = {})
+      internal_remove(REMOVE, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class UserOptionsService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Adds a new user profile property of type JSON.
+    # 
+    # Example request(for user with identifier `123`):
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/users/123/options
+    # ----
+    # 
+    # Payload:
+    # 
+    # [source,xml]
+    # ----
+    #   <user_option>
+    #     <name>SomeName</name>
+    #     <content>["any", "JSON"]</content>
+    #   </user_option>
+    # ----
+    # 
+    # @param option [UserOption] The `option` to add.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [UserOption]
+    # 
+    def add(option, opts = {})
+      internal_add(option, UserOption, ADD, opts)
+    end
+    
+    LIST = [
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Returns a list of user profile properties of type JSON.
+    # 
+    # Example request(for user with identifier `123`):
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/users/123/options
+    # ----
+    # 
+    # The result will be the following XML document:
+    # 
+    # [source,xml]
+    # ----
+    # <user_options>
+    #   <user_option href="/ovirt-engine/api/users/123/options/456" id="456">
+    #     <name>SomeName</name>
+    #     <content>["any", "JSON"]</content>
+    #     <user href="/ovirt-engine/api/users/123" id="123"/>
+    #   </user_option>
+    # </user_options>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<UserOption>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Locates the `option` service.
+    # 
+    # @param id [String] The identifier of the `option`.
+    # 
+    # @return [UserOptionService] A reference to the `option` service.
+    # 
+    def option_service(id)
+      UserOptionService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return option_service(path)
+      end
+      return option_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
   class UsersService < Service
     
     ADD = [
@@ -29046,7 +29844,7 @@ module OvirtSDK4
     # ----
     # 
     # In case you are working with Active Directory you have to pass user principal name (UPN) as `username`, followed
-    # by authorization provider name. Due to https://bugzilla.redhat.com/1147900[bug 1147900] you need to provide
+    # by authorization provider name. Due to link:https://bugzilla.redhat.com/1147900[bug 1147900] you need to provide
     # also `principal` parameter set to UPN of the user.
     # 
     # For example, to add the user with UPN `myuser@mysubdomain.mydomain.com` from the `myextension-authz`
@@ -29351,6 +30149,55 @@ module OvirtSDK4
   
   class VmService < MeasurableService
     
+    AUTO_PIN_CPU_AND_NUMA_NODES = [
+      [:async, TrueClass].freeze,
+      [:optimize_cpu_settings, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :AUTO_PIN_CPU_AND_NUMA_NODES
+    
+    # 
+    # Apply an automatic CPU and NUMA configuration on the VM.
+    # 
+    # IMPORTANT: Since version 4.5 of the engine this operation is deprecated, and preserved only for backwards
+    # compatibility. It will be removed in the future. Instead please use PUT followed by xref:services-vm-methods-update[update operation].
+    # 
+    # An example for a request:
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/autopincpuandnumanodes
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <optimize_cpu_settings>true</optimize_cpu_settings>
+    # </action>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the detach action should be performed asynchronously.
+    # 
+    # @option opts [Boolean] :optimize_cpu_settings Specifies how the auto CPU and NUMA configuration is applied.
+    #   If set to true, will adjust the CPU topology to fit the VM pinned host hardware.
+    #   Otherwise, it will use the VM CPU topology.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def auto_pin_cpu_and_numa_nodes(opts = {})
+      internal_action(:autopincpuandnumanodes, nil, AUTO_PIN_CPU_AND_NUMA_NODES, opts)
+    end
+    
     CANCEL_MIGRATION = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -29435,7 +30282,7 @@ module OvirtSDK4
     # 
     # Permanently restores the virtual machine to the state of the previewed snapshot.
     # 
-    # See the <<services/vm/methods/preview_snapshot, preview_snapshot>> operation for details.
+    # See the xref:services-vm-methods-preview_snapshot[preview_snapshot] operation for details.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29547,6 +30394,8 @@ module OvirtSDK4
     # </action>
     # ----
     # 
+    # NOTE: Confirm that the export operation has completed before attempting any actions on the export domain.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the export should be performed asynchronously.
@@ -29619,6 +30468,7 @@ module OvirtSDK4
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
       [:next_run, TrueClass].freeze,
+      [:ovf_as_ova, TrueClass].freeze,
     ].freeze
     
     private_constant :GET
@@ -29671,6 +30521,16 @@ module OvirtSDK4
     #   GET /vms/{vm:id};next_run=true
     #   ----
     # 
+    # @option opts [Boolean] :ovf_as_ova Indicates if the results should expose the OVF as it appears in OVA files of that VM. The OVF document
+    #   describing the virtual machine. This parameter will work only when all_content=True is set.
+    #   The OVF will be presented in `initialization.configuration.data`.
+    #   
+    #   For example:
+    #   [source]
+    #   ----
+    #   GET /vms/{vm:id}?all_content=true&ovf_as_ova=true
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -29857,8 +30717,8 @@ module OvirtSDK4
     # 
     # The snapshot is indicated with the `snapshot.id` parameter. It is restored temporarily, so that the content can
     # be inspected. Once that inspection is finished, the state of the virtual machine can be made permanent, using the
-    # <<services/vm/methods/commit_snapshot, commit_snapshot>> method, or discarded using the
-    # <<services/vm/methods/undo_snapshot, undo_snapshot>> method.
+    # xref:services-vm-methods-commit_snapshot[commit_snapshot] method, or discarded using the
+    # xref:services-vm-methods-undo_snapshot[undo_snapshot] method.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29919,6 +30779,7 @@ module OvirtSDK4
     
     REBOOT = [
       [:async, TrueClass].freeze,
+      [:force, TrueClass].freeze,
     ].freeze
     
     private_constant :REBOOT
@@ -29941,10 +30802,29 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # To reboot the VM even if a backup is running for it,
+    # the action should include the 'force' element.
+    # 
+    # For example, to force reboot virtual machine `123`:
+    # 
+    # ----
+    # POST /ovirt-engine/api/vms/123/reboot
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <force>true</force>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the reboot should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the VM should be forcibly rebooted even
+    #   if a backup is running for it.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -30023,8 +30903,90 @@ module OvirtSDK4
       internal_action(:reordermacaddresses, nil, REORDER_MAC_ADDRESSES, opts)
     end
     
+    RESET = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :RESET
+    
+    # 
+    # Sends a reset request to a virtual machine.
+    # 
+    # For example:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/reset
+    # ----
+    # 
+    # The reset action does not take any action specific parameters; therefore, the request body should contain an
+    # empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the reset should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def reset(opts = {})
+      internal_action(:reset, nil, RESET, opts)
+    end
+    
+    SCREENSHOT = [
+    ].freeze
+    
+    private_constant :SCREENSHOT
+    
+    # 
+    # Captures screenshot of the current state of the VM.
+    # 
+    # For example:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/screenshot
+    # ----
+    # 
+    # The screenshot action does not take any action specific parameters; therefore, the request body should contain an
+    # empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # 
+    # 
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def screenshot(opts = {})
+      internal_action(:screenshot, nil, SCREENSHOT, opts)
+    end
+    
     SHUTDOWN = [
       [:async, TrueClass].freeze,
+      [:force, TrueClass].freeze,
       [:reason, String].freeze,
     ].freeze
     
@@ -30048,10 +31010,29 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # To shutdown the VM even if a backup is running for it,
+    # the action should include the 'force' element.
+    # 
+    # For example, to force shutdown virtual machine `123`:
+    # 
+    # ----
+    # POST /ovirt-engine/api/vms/123/shutdown
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <force>true</force>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the shutdown should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the VM should be forcibly shutdown even
+    #   if a backup is running for it.
+    # 
     # @option opts [String] :reason The reason the virtual machine was stopped.
     #   Optionally set by user when shutting down the virtual machine.
     # 
@@ -30114,10 +31095,10 @@ module OvirtSDK4
     # @option opts [Boolean] :pause If set to `true`, start the virtual machine in paused mode. The default is `false`.
     # 
     # @option opts [Boolean] :use_cloud_init If set to `true`, the initialization type is set to _cloud-init_. The default value is `false`.
-    #   See https://cloudinit.readthedocs.io/en/latest[this] for details.
+    #   See link:https://cloudinit.readthedocs.io/en/latest[cloud-init documentation] for details.
     # 
     # @option opts [Boolean] :use_ignition If set to `true`, the initialization type is set to _Ignition_. The default value is `false`.
-    #   See https://coreos.com/ignition/docs/latest/[this] for details.
+    #   See link:https://coreos.com/ignition/docs/latest/[Ignition documentation] for details.
     # 
     # @option opts [Boolean] :use_initialization If set to `true`, the initialization type is set by the VM's OS.
     #   Windows will set to _Sysprep_, Linux to _cloud-init_ and RedHat CoreOS to _Ignition_.
@@ -30126,7 +31107,7 @@ module OvirtSDK4
     #   The default value is `false`.
     # 
     # @option opts [Boolean] :use_sysprep If set to `true`, the initialization type is set to _Sysprep_. The default value is `false`.
-    #   See https://en.wikipedia.org/wiki/Sysprep[this] for details.
+    #   See link:https://en.wikipedia.org/wiki/Sysprep[Sysprep] for details.
     # 
     # @option opts [Vm] :vm The definition of the virtual machine for this specific run.
     #   
@@ -30168,6 +31149,7 @@ module OvirtSDK4
     
     STOP = [
       [:async, TrueClass].freeze,
+      [:force, TrueClass].freeze,
       [:reason, String].freeze,
     ].freeze
     
@@ -30191,10 +31173,29 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # To stop the VM even if a backup is running for it,
+    # the action should include the 'force' element.
+    # 
+    # For example, to force stop virtual machine `123`:
+    # 
+    # ----
+    # POST /ovirt-engine/api/vms/123/stop
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <force>true</force>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the stop action should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the VM should be forcibly stop even
+    #   if a backup is running for it.
+    # 
     # @option opts [String] :reason The reason the virtual machine was stopped.
     #   Optionally set by user when shutting down the virtual machine.
     # 
@@ -30335,8 +31336,8 @@ module OvirtSDK4
     # the SPICE protocol.
     # 
     # In order to obtain an authentication token for a specific protocol, for
-    # example for VNC, use the `ticket` method of the <<services/vm_graphics_console,
-    # service>>, which manages the graphics consoles of the virtual machine, by sending
+    # example for VNC, use the `ticket` method of the
+    # xref:services-vm_graphics_console[service], which manages the graphics consoles of the virtual machine, by sending
     # a request:
     # 
     # [source]
@@ -30459,7 +31460,7 @@ module OvirtSDK4
     # 
     # Restores the virtual machine to the state it had before previewing the snapshot.
     # 
-    # See the <<services/vm/methods/preview_snapshot, preview_snapshot>> operation for details.
+    # See the xref:services-vm-methods-preview_snapshot[preview_snapshot] operation for details.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30548,6 +31549,15 @@ module OvirtSDK4
       @cdroms_service ||= VmCdromsService.new(self, 'cdroms')
     end
     
+    # 
+    # List of checkpoints of this virtual machine.
+    # 
+    # @return [VmCheckpointsService] A reference to `checkpoints` service.
+    # 
+    def checkpoints_service
+      @checkpoints_service ||= VmCheckpointsService.new(self, 'checkpoints')
+    end
+    
     # 
     # List of disks attached to this virtual machine.
     # 
@@ -30585,6 +31595,15 @@ module OvirtSDK4
       @katello_errata_service ||= KatelloErrataService.new(self, 'katelloerrata')
     end
     
+    # 
+    # Reference to the service that manages mediated devices associated with the VM.
+    # 
+    # @return [VmMediatedDevicesService] A reference to `mediated_devices` service.
+    # 
+    def mediated_devices_service
+      @mediated_devices_service ||= VmMediatedDevicesService.new(self, 'mediateddevices')
+    end
+    
     # 
     # Locates the `nics` service.
     # 
@@ -30701,6 +31720,12 @@ module OvirtSDK4
       if path.start_with?('cdroms/')
         return cdroms_service.service(path[7..-1])
       end
+      if path == 'checkpoints'
+        return checkpoints_service
+      end
+      if path.start_with?('checkpoints/')
+        return checkpoints_service.service(path[12..-1])
+      end
       if path == 'diskattachments'
         return disk_attachments_service
       end
@@ -30725,6 +31750,12 @@ module OvirtSDK4
       if path.start_with?('katelloerrata/')
         return katello_errata_service.service(path[14..-1])
       end
+      if path == 'mediateddevices'
+        return mediated_devices_service
+      end
+      if path.start_with?('mediateddevices/')
+        return mediated_devices_service.service(path[16..-1])
+      end
       if path == 'nics'
         return nics_service
       end
@@ -30915,6 +31946,20 @@ module OvirtSDK4
     # Finalize the virtual machine backup entity.
     # 
     # End backup, unlock resources, and perform cleanups.
+    # To finalize a virtual machine with an id '123' and a backup with an id '456'
+    # send a request as follows:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/backups/456/finalize
+    # ----
+    # 
+    # With a request body as follows:
+    # 
+    # [source,xml]
+    # ----
+    # <action />
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -31106,6 +32151,8 @@ module OvirtSDK4
   class VmBackupsService < Service
     
     ADD = [
+      [:require_consistency, TrueClass].freeze,
+      [:use_active, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -31125,7 +32172,6 @@ module OvirtSDK4
     # 
     # [source,xml]
     # ----
-    # POST /ovirt-engine/api/vms/123/backups
     # <backup>
     #   <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
     #   <disks>
@@ -31152,10 +32198,55 @@ module OvirtSDK4
     # </backup>
     # ----
     # 
+    # To provide the ID of the created backup, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/backups
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <backup id="backup-uuid">
+    #   <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
+    #   <disks>
+    #       <disk id="disk-uuid" />
+    #       ...
+    #   </disks>
+    # </backup>
+    # ----
+    # 
     # @param backup [Backup] The information about the virtual machine backup entity.
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :require_consistency Indicates if the backup will fail if VM failed to freeze or not.
+    #   
+    #   If requireConsistency=True VM backup will fail in case of a
+    #   failure to freeze the VM.
+    #   
+    #   The REST API call should look like this:
+    #   
+    #   ....
+    #   POST /ovirt-engine/api/vms/123/backups?require_consistency=true
+    #   ....
+    #   
+    #   The default value of the requireConsistency flag is `false`.
+    # 
+    # @option opts [Boolean] :use_active Indicate whether to use the active volume for performing the backup.
+    #   
+    #   If useActive=False a snapshot will be created for the backup operation.
+    #   
+    #   The REST API call should look like this:
+    #   
+    #   ....
+    #   POST /ovirt-engine/api/vms/123/backups?use_active=false
+    #   ....
+    #   
+    #   The default value of the useActive flag is `false`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -31330,7 +32421,7 @@ module OvirtSDK4
     # ----
     # 
     # 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
+    # after the next boot, but they do not 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:
     # 
@@ -31483,20 +32574,21 @@ module OvirtSDK4
     
   end
   
-  class VmDiskService < MeasurableService
+  class VmCheckpointService < Service
     
-    ACTIVATE = [
-      [:async, TrueClass].freeze,
+    GET = [
+      [:follow, String].freeze,
     ].freeze
     
-    private_constant :ACTIVATE
+    private_constant :GET
     
     # 
-    # Executes the `activate` method.
+    # Returns information about the virtual machine checkpoint.
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :async Indicates if the activation should be performed asynchronously.
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -31507,23 +32599,26 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :wait (true) If `true` wait for the response.
     # 
-    def activate(opts = {})
-      internal_action(:activate, nil, ACTIVATE, opts)
+    # @return [Checkpoint]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
     end
     
-    DEACTIVATE = [
+    REMOVE = [
       [:async, TrueClass].freeze,
     ].freeze
     
-    private_constant :DEACTIVATE
+    private_constant :REMOVE
     
     # 
-    # Executes the `deactivate` method.
+    # Remove the virtual machine checkpoint entity.
     # 
-    # @param opts [Hash] Additional options.
+    # Remove the checkpoint from libvirt and the database.
     # 
-    # @option opts [Boolean] :async Indicates if the deactivation should be performed asynchronously.
+    # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -31533,39 +32628,43 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :wait (true) If `true` wait for the response.
     # 
-    def deactivate(opts = {})
-      internal_action(:deactivate, nil, DEACTIVATE, opts)
+    def remove(opts = {})
+      internal_remove(REMOVE, opts)
     end
     
-    EXPORT = [
-      [:async, TrueClass].freeze,
-      [:filter, TrueClass].freeze,
-    ].freeze
-    
-    private_constant :EXPORT
-    
     # 
-    # Executes the `export` method.
+    # A reference to the service that lists the disks in checkpoint.
     # 
-    # @param opts [Hash] Additional options.
+    # @return [VmCheckpointDisksService] A reference to `disks` service.
     # 
-    # @option opts [Boolean] :async Indicates if the export should be performed asynchronously.
-    # 
-    # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
-    # 
-    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    def disks_service
+      @disks_service ||= VmCheckpointDisksService.new(self, 'disks')
+    end
+    
     # 
-    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # Locates the service corresponding to the given path.
     # 
-    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
-    #   given then the timeout set globally for the connection will be used.
+    # @param path [String] The path of the service.
     # 
-    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # @return [Service] A reference to the service.
     # 
-    def export(opts = {})
-      internal_action(:export, nil, EXPORT, opts)
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      if path == 'disks'
+        return disks_service
+      end
+      if path.start_with?('disks/')
+        return disks_service.service(path[6..-1])
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
     end
     
+  end
+  
+  class VmCheckpointDiskService < Service
+    
     GET = [
       [:follow, String].freeze,
     ].freeze
@@ -31573,7 +32672,273 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves the description of the disk.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Disk]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class VmCheckpointDisksService < Service
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Returns the list of disks in checkpoint.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of disks to return. If not specified, all the disks are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<Disk>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # A reference to the service that manages a specific disk.
+    # 
+    # @param id [String] The identifier of the `disk`.
+    # 
+    # @return [VmCheckpointDiskService] A reference to the `disk` service.
+    # 
+    def disk_service(id)
+      VmCheckpointDiskService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return disk_service(path)
+      end
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
+  class VmCheckpointsService < Service
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # The list of virtual machine checkpoints.
+    # 
+    # To get a list of checkpoints for a virtual machine with an id '123', send a request as follows:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vms/123/checkpoints
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of virtual machine checkpoints to return.
+    #   If not specified, all the virtual machine checkpoints are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<Checkpoint>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Returns a reference to the service that manages a specific VM checkpoint.
+    # 
+    # @param id [String] The identifier of the `checkpoint`.
+    # 
+    # @return [VmCheckpointService] A reference to the `checkpoint` service.
+    # 
+    def checkpoint_service(id)
+      VmCheckpointService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return checkpoint_service(path)
+      end
+      return checkpoint_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
+  class VmDiskService < MeasurableService
+    
+    ACTIVATE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :ACTIVATE
+    
+    # 
+    # Executes the `activate` method.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the activation should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def activate(opts = {})
+      internal_action(:activate, nil, ACTIVATE, opts)
+    end
+    
+    DEACTIVATE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :DEACTIVATE
+    
+    # 
+    # Executes the `deactivate` method.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the deactivation should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def deactivate(opts = {})
+      internal_action(:deactivate, nil, DEACTIVATE, opts)
+    end
+    
+    EXPORT = [
+      [:async, TrueClass].freeze,
+      [:filter, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :EXPORT
+    
+    # 
+    # Executes the `export` method.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the export should be performed asynchronously.
+    # 
+    # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def export(opts = {})
+      internal_action(:export, nil, EXPORT, opts)
+    end
+    
+    GET = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Returns the representation of the object managed by this service.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -31664,8 +33029,7 @@ module OvirtSDK4
     # Detach the disk from the virtual machine.
     # 
     # NOTE: In version 3 of the API this used to also remove the disk completely from the system, but starting with
-    # version 4 it doesn't. If you need to remove it completely use the <<services/disk/methods/remove,remove
-    # method of the top level disk service>>.
+    # version 4 it doesn't. If you need to remove it completely use the xref:services-disk-methods-remove[remove method of the top level disk service].
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32373,7 +33737,7 @@ module OvirtSDK4
     # POST /ovirt-engine/api/vms/123/hostdevices
     # ----
     # 
-    # With request body of type <<types/host_device,HostDevice>>, for example
+    # With request body of type xref:types-host_device[HostDevice], for example
     # 
     # [source,xml]
     # ----
@@ -32385,7 +33749,7 @@ module OvirtSDK4
     # 
     # 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 <<types/host_device,HostDevice>> type set to `true`.
+    # attribute of the xref:types-host_device[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.
@@ -32474,6 +33838,238 @@ module OvirtSDK4
     
   end
   
+  class VmMediatedDeviceService < Service
+    
+    GET = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Retrieves the configuration of mediated devices in the virtual machine.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [VmMediatedDevice]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    REMOVE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Remove the mediated device from the virtual machine.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def remove(opts = {})
+      internal_remove(REMOVE, opts)
+    end
+    
+    UPDATE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :UPDATE
+    
+    # 
+    # Updates the information about the mediated device.
+    # 
+    # You can update the information using `specParams` element.
+    # 
+    # For example, to update a mediated device, send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vms/123/mediateddevices/00000000-0000-0000-0000-000000000000
+    # <vm_mediated_device>
+    #   <spec_params>
+    #     <property>
+    #       <name>mdevType</name>
+    #       <value>nvidia-11</value>
+    #     </property>
+    #   </spec_params>
+    # </vm_mediated_device>
+    # ----
+    # 
+    # with response body:
+    # 
+    # [source,xml]
+    # ----
+    # <vm_mediated_device href="/ovirt-engine/api/vms/123/mediateddevices/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000">
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    #   <spec_params>
+    #     <property>
+    #       <name>mdevType</name>
+    #       <value>nvidia-11</value>
+    #     </property>
+    #   </spec_params>
+    # </vm_mediated_device>
+    # ----
+    # 
+    # @param device [VmMediatedDevice] The information about the mediated device.
+    #   
+    #   The request data must contain `specParams` properties.
+    #   The response data contains complete information about the
+    #   updated mediated device.
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [VmMediatedDevice]
+    # 
+    def update(device, opts = {})
+      internal_update(device, VmMediatedDevice, UPDATE, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class VmMediatedDevicesService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Add a new mediated device to the virtual machine.
+    # 
+    # @param device [VmMediatedDevice] The `device` to add.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [VmMediatedDevice]
+    # 
+    def add(device, opts = {})
+      internal_add(device, VmMediatedDevice, ADD, opts)
+    end
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Lists all the configured mediated devices of the virtual machine.
+    # 
+    # The order of the returned list of mediated devices is not guaranteed.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of mediated devices to return.
+    #   If not specified all the mediated devices are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<VmMediatedDevice>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Returns a reference to the service that manages a mediated device of a virtual machine.
+    # 
+    # @param id [String] The identifier of the `device`.
+    # 
+    # @return [VmMediatedDeviceService] A reference to the `device` service.
+    # 
+    def device_service(id)
+      VmMediatedDeviceService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    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
+    
+  end
+  
   class VmNicService < MeasurableService
     
     ACTIVATE = [
@@ -32662,7 +34258,7 @@ module OvirtSDK4
     # 
     # Reference to the service that manages the network filter parameters of the NIC.
     # 
-    # A single top-level network filter may assigned to the NIC by the NIC's <<types/vnic_profile,vNIC Profile>>.
+    # A single top-level network filter may assigned to the NIC by the NIC's xref:types-vnic_profile[vNIC Profile].
     # 
     # @return [NicNetworkFilterParametersService] A reference to `network_filter_parameters` service.
     # 
@@ -33027,6 +34623,7 @@ module OvirtSDK4
     #   </cpu>
     #   <index>0</index>
     #   <memory>1024</memory>
+    #   <numa_tune_mode>strict</numa_tune_mode>
     # </vm_numa_node>
     # ----
     # 
@@ -33245,6 +34842,7 @@ module OvirtSDK4
     
     UPDATE = [
       [:async, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :UPDATE
@@ -33277,6 +34875,33 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
     # 
+    # @option opts [Boolean] :seal Specifies if virtual machines created for the pool should be sealed after creation.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, virtual machines created for the pool
+    #   will be sealed after creation. If the value is 'false', the virtual machines will not be sealed.
+    #   If the parameter is not provided, the virtual machines will be sealed, only if they are created from
+    #   a sealed template and their guest OS is not set to Windows. This parameter affects only the virtual machines
+    #   created when the pool is updated.
+    #   
+    #   For example, to update a virtual machine pool and to seal the additional virtual machines that are created,
+    #   send a request like this:
+    #   
+    #   [source]
+    #   ----
+    #   PUT /ovirt-engine/api/vmpools/123?seal=true
+    #   ----
+    #   
+    #   With the following body:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <vmpool>
+    #     <name>VM_Pool_B</name>
+    #     <description>Virtual Machine Pool B</description>
+    #     <size>7</size>
+    #   </vmpool>
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -33326,6 +34951,7 @@ module OvirtSDK4
   class VmPoolsService < Service
     
     ADD = [
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -33356,6 +34982,34 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :seal Specifies if virtual machines created for the pool should be sealed after creation.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, virtual machines created for the pool
+    #   will be sealed after creation. If the value is 'false', the virtual machines will not be sealed.
+    #   If the parameter is not provided, the virtual machines will be sealed, only if they are created from
+    #   a sealed template and their guest OS is not set to Windows. This parameter affects only the virtual machines
+    #   created when the pool is created.
+    #   
+    #   For example, to create a virtual machine pool with 5 virtual machines and to seal them, send a request
+    #   like this:
+    #   
+    #   [source]
+    #   ----
+    #   POST /ovirt-engine/api/vmpools?seal=true
+    #   ----
+    #   
+    #   With the following body:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <vmpool>
+    #     <name>mypool</name>
+    #     <cluster id="123"/>
+    #     <template id="456"/>
+    #     <size>5</size>
+    #   </vmpool>
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -33978,6 +35632,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -34118,7 +35773,7 @@ module OvirtSDK4
     # ----
     # 
     # In order to boot from CDROM, you first need to insert a disk, as described in the
-    # <<services/vm_cdrom, CDROM service>>. Then booting from that CDROM can be specified using the `os.boot.devices`
+    # xref:services-vm_cdrom[CDROM service]. Then booting from that CDROM can be specified using the `os.boot.devices`
     # attribute:
     # 
     # [source,xml]
@@ -34144,7 +35799,7 @@ module OvirtSDK4
     # @option opts [Boolean] :clone Specifies if the virtual machine should be independent of the template.
     #   
     #   When a virtual machine is created from a template by default the disks of the virtual machine depend on
-    #   the disks of the template, they are using the https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
+    #   the disks of the template, they are using the link:https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
     #   mechanism so that only the differences from the template take up real storage space. If this parameter is
     #   specified and the value is `true` then the disks of the created virtual machine will be _cloned_, and
     #   independent of the template. For example, to create an independent virtual machine, send a request like this:
@@ -34207,6 +35862,36 @@ module OvirtSDK4
     #   Machine will fail unless the Virtual Machine has been previously created by the admin as
     #   a user (meaning with filter=true).
     # 
+    # @option opts [Boolean] :seal Specifies if the virtual machine should be sealed after creation.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, the virtual machine will be sealed after
+    #   creation. If the value is 'false', the virtual machine will not be sealed. If the parameter is not provided,
+    #   the virtual machine will be sealed, only if it is created from a sealed template and its guest OS is not set
+    #   to Windows.
+    #   
+    #   For example, to create a virtual machine from the `mytemplate` template and to seal it, send a request
+    #   like this:
+    #   
+    #   [source]
+    #   ----
+    #   POST /ovirt-engine/api/vms?seal=true
+    #   ----
+    #   
+    #   With a request body like this:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <vm>
+    #     <name>myvm<name>
+    #     <template>
+    #       <name>mytemplate<name>
+    #     </template>
+    #     <cluster>
+    #       <name>mycluster<name>
+    #     </cluster>
+    #   </vm>
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -34226,6 +35911,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_CONFIGURATION
@@ -34240,7 +35926,7 @@ module OvirtSDK4
     # @option opts [Boolean] :clone Specifies if the virtual machine should be independent of the template.
     #   
     #   When a virtual machine is created from a template by default the disks of the virtual machine depend on
-    #   the disks of the template, they are using the https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
+    #   the disks of the template, they are using the link:https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
     #   mechanism so that only the differences from the template take up real storage space. If this parameter is
     #   specified and the value is `true` then the disks of the created virtual machine will be _cloned_, and
     #   independent of the template. For example, to create an independent virtual machine, send a request like this:
@@ -34303,6 +35989,36 @@ module OvirtSDK4
     #   Machine will fail unless the Virtual Machine has been previously created by the admin as
     #   a user (meaning with filter=true).
     # 
+    # @option opts [Boolean] :seal Specifies if the virtual machine should be sealed after creation.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, the virtual machine will be sealed after
+    #   creation. If the value is 'false', the virtual machine will not be sealed. If the parameter is not provided,
+    #   the virtual machine will be sealed, only if it is created from a sealed template and its guest OS is not set
+    #   to Windows.
+    #   
+    #   For example, to create a virtual machine from the `mytemplate` template and to seal it, send a request
+    #   like this:
+    #   
+    #   [source]
+    #   ----
+    #   POST /ovirt-engine/api/vms?seal=true
+    #   ----
+    #   
+    #   With a request body like this:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <vm>
+    #     <name>myvm<name>
+    #     <template>
+    #       <name>mytemplate<name>
+    #     </template>
+    #     <cluster>
+    #       <name>mycluster<name>
+    #     </cluster>
+    #   </vm>
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -34322,6 +36038,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_SCRATCH
@@ -34336,7 +36053,7 @@ module OvirtSDK4
     # @option opts [Boolean] :clone Specifies if the virtual machine should be independent of the template.
     #   
     #   When a virtual machine is created from a template by default the disks of the virtual machine depend on
-    #   the disks of the template, they are using the https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
+    #   the disks of the template, they are using the link:https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
     #   mechanism so that only the differences from the template take up real storage space. If this parameter is
     #   specified and the value is `true` then the disks of the created virtual machine will be _cloned_, and
     #   independent of the template. For example, to create an independent virtual machine, send a request like this:
@@ -34399,6 +36116,36 @@ module OvirtSDK4
     #   Machine will fail unless the Virtual Machine has been previously created by the admin as
     #   a user (meaning with filter=true).
     # 
+    # @option opts [Boolean] :seal Specifies if the virtual machine should be sealed after creation.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, the virtual machine will be sealed after
+    #   creation. If the value is 'false', the virtual machine will not be sealed. If the parameter is not provided,
+    #   the virtual machine will be sealed, only if it is created from a sealed template and its guest OS is not set
+    #   to Windows.
+    #   
+    #   For example, to create a virtual machine from the `mytemplate` template and to seal it, send a request
+    #   like this:
+    #   
+    #   [source]
+    #   ----
+    #   POST /ovirt-engine/api/vms?seal=true
+    #   ----
+    #   
+    #   With a request body like this:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <vm>
+    #     <name>myvm<name>
+    #     <template>
+    #       <name>mytemplate<name>
+    #     </template>
+    #     <cluster>
+    #       <name>mycluster<name>
+    #     </cluster>
+    #   </vm>
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -34418,6 +36165,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_SNAPSHOT
@@ -34432,7 +36180,7 @@ module OvirtSDK4
     # @option opts [Boolean] :clone Specifies if the virtual machine should be independent of the template.
     #   
     #   When a virtual machine is created from a template by default the disks of the virtual machine depend on
-    #   the disks of the template, they are using the https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
+    #   the disks of the template, they are using the link:https://en.wikipedia.org/wiki/Copy-on-write[_copy on write_]
     #   mechanism so that only the differences from the template take up real storage space. If this parameter is
     #   specified and the value is `true` then the disks of the created virtual machine will be _cloned_, and
     #   independent of the template. For example, to create an independent virtual machine, send a request like this:
@@ -34495,6 +36243,36 @@ module OvirtSDK4
     #   Machine will fail unless the Virtual Machine has been previously created by the admin as
     #   a user (meaning with filter=true).
     # 
+    # @option opts [Boolean] :seal Specifies if the virtual machine should be sealed after creation.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, the virtual machine will be sealed after
+    #   creation. If the value is 'false', the virtual machine will not be sealed. If the parameter is not provided,
+    #   the virtual machine will be sealed, only if it is created from a sealed template and its guest OS is not set
+    #   to Windows.
+    #   
+    #   For example, to create a virtual machine from the `mytemplate` template and to seal it, send a request
+    #   like this:
+    #   
+    #   [source]
+    #   ----
+    #   POST /ovirt-engine/api/vms?seal=true
+    #   ----
+    #   
+    #   With a request body like this:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <vm>
+    #     <name>myvm<name>
+    #     <template>
+    #       <name>mytemplate<name>
+    #     </template>
+    #     <cluster>
+    #       <name>mycluster<name>
+    #     </cluster>
+    #   </vm>
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -34516,6 +36294,7 @@ module OvirtSDK4
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
       [:max, Integer].freeze,
+      [:ovf_as_ova, TrueClass].freeze,
       [:search, String].freeze,
     ].freeze
     
@@ -34559,6 +36338,16 @@ module OvirtSDK4
     # 
     # @option opts [Integer] :max The maximum number of results to return.
     # 
+    # @option opts [Boolean] :ovf_as_ova Indicates if the results should expose the OVF as it appears in OVA files of that VM. The OVF document
+    #   describing the virtual machine. This parameter will work only when all_content=True is set.
+    #   The OVF will be presented in `initialization.configuration.data`.
+    #   
+    #   For example:
+    #   [source]
+    #   ----
+    #   GET /vms?all_content=true&ovf_as_ova=true
+    #   ----
+    # 
     # @option opts [String] :search A query string used to restrict the returned virtual machines.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -34755,7 +36544,7 @@ module OvirtSDK4
     # 
     # Please note that there is a default network filter to each VNIC profile.
     # For more details of how the default network filter is calculated please refer to
-    # the documentation in <<services/network_filters,NetworkFilters>>.
+    # the documentation in xref:services-network_filters[NetworkFilters].
     # 
     # NOTE: The automatically created vNIC profile for the external network will be without network filter.
     # 
@@ -35067,7 +36856,7 @@ module OvirtSDK4
     # Copies a disk to the specified storage domain.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To copy a disk use the <<services/disk/methods/copy, copy>>
+    # compatibility. It will be removed in the future. To copy a disk use the xref:services-disk-methods-copy[copy]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -35099,7 +36888,7 @@ module OvirtSDK4
     # Exports a disk to an export storage domain.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To export a disk use the <<services/disk/methods/export, export>>
+    # compatibility. It will be removed in the future. To export a disk use the xref:services-disk-methods-export[export]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -35160,7 +36949,7 @@ module OvirtSDK4
     # Moves a disk to another storage domain.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To move a disk use the <<services/disk/methods/move, move>>
+    # compatibility. It will be removed in the future. To move a disk use the xref:services-disk-methods-move[move]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -35216,7 +37005,7 @@ module OvirtSDK4
     # Removes a disk.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To remove a disk use the <<services/disk/methods/remove, remove>>
+    # compatibility. It will be removed in the future. To remove a disk use the xref:services-disk-methods-remove[remove]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -35243,7 +37032,7 @@ module OvirtSDK4
     # Sparsify the disk.
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
-    # compatibility. It will be removed in the future. To remove a disk use the <<services/disk/methods/remove, remove>>
+    # compatibility. It will be removed in the future. To remove a disk use the xref:services-disk-methods-remove[remove]
     # operation of the service that manages that disk.
     # 
     # @param opts [Hash] Additional options.
@@ -35271,7 +37060,7 @@ module OvirtSDK4
     # 
     # IMPORTANT: Since version 4.2 of the engine this operation is deprecated, and preserved only for backwards
     # compatibility. It will be removed in the future. To update a disk use the
-    # <<services/disk/methods/update, update>> operation of the service that manages that disk.
+    # xref:services-disk-methods-update[update] operation of the service that manages that disk.
     # 
     # @param disk [Disk] The update to apply to the disk.
     # @param opts [Hash] Additional options.
@@ -35339,6 +37128,60 @@ module OvirtSDK4
   
   class DiskService < MeasurableService
     
+    CONVERT = [
+      [:disk, Disk].freeze,
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :CONVERT
+    
+    # 
+    # Converts disk format and/or preallocation mode.
+    # 
+    # For example, to convert the disk format from preallocated-cow to a sparse-raw image,
+    # send a request like the following:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/disks/123/convert
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    #  <action>
+    #    <disk>
+    #      <sparse>true</sparse>
+    #      <format>raw</format>
+    #    </disk>
+    #  </action>
+    # ----
+    # 
+    # Note: In order to sparsify a disk, two conversions might be needed if the disk is on a Block Storage Domain.
+    # For example: If a disk is RAW, converting it to QCOW will result in a larger disk. In order to reduce the size,
+    # it is possible to convert the disk again to QCOW and keep the same allocation policy.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Disk] :disk The description of the disk.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def convert(opts = {})
+      internal_action(:convert, nil, CONVERT, opts)
+    end
+    
     COPY = [
       [:async, TrueClass].freeze,
       [:disk, Disk].freeze,
@@ -35638,7 +37481,7 @@ module OvirtSDK4
     # Refreshing a direct LUN disk is useful when:
     # 
     # - The LUN was added using the API without the host parameter, and therefore does not contain
-    #   any information from the storage (see <<services/disks/methods/add, DisksService::add>>).
+    #   any information from the storage (see xref:services-disks-methods-add[DisksService::add]).
     # - New information about the LUN is available on the storage and you want to update the LUN with it.
     # 
     # To refresh direct LUN disk `123` using host `456`, send the following request:
@@ -35742,7 +37585,9 @@ module OvirtSDK4
     # 
     # * For LUN disks: `alias`, `description` and `shareable`.
     # 
-    # * For Cinder and Managed Block disks: `provisioned_size`, `alias` and `description`.
+    # * Cinder integration has been replaced by Managed Block Storage.
+    # 
+    # * For Managed Block disks: `provisioned_size`, `alias` and `description`.
     # 
     # * For VM attached disks, the `qcow_version` can also be updated.
     # 
@@ -35785,6 +37630,26 @@ module OvirtSDK4
       internal_update(disk, Disk, UPDATE, opts)
     end
     
+    # 
+    # Reference to the service that manages the DiskSnapshots.
+    # 
+    # For example, to list all disk snapshots under the disks resource '123':
+    # 
+    # ....
+    # GET /ovirt-engine/api/disks/123/disksnapshots
+    # ....
+    # 
+    # For example, to retrieve a specific disk snapshot '789' under the disk resource '123':
+    # ....
+    # GET /ovirt-engine/api/disks/123/disksnapshots/789
+    # ....
+    # 
+    # @return [DiskSnapshotsService] A reference to `disk_snapshots` service.
+    # 
+    def disk_snapshots_service
+      @disk_snapshots_service ||= DiskSnapshotsService.new(self, 'disksnapshots')
+    end
+    
     # 
     # Reference to the service that manages the permissions assigned to the disk.
     # 
@@ -35814,6 +37679,12 @@ module OvirtSDK4
       if path.nil? || path == ''
         return self
       end
+      if path == 'disksnapshots'
+        return disk_snapshots_service
+      end
+      if path.start_with?('disksnapshots/')
+        return disk_snapshots_service.service(path[14..-1])
+      end
       if path == 'permissions'
         return permissions_service
       end
@@ -36272,7 +38143,7 @@ module OvirtSDK4
     # 
     # Removes a brick from the underlying gluster volume and deletes entries from database. This can be used only when
     # removing a single brick without data migration. To remove multiple bricks and with data migration, use
-    # <<services/gluster_bricks/methods/migrate, migrate>> instead.
+    # xref:services-gluster_bricks-methods-migrate[migrate] instead.
     # 
     # For example, to delete brick `234` from gluster volume `123`, send a request like this:
     # 
@@ -36308,8 +38179,8 @@ module OvirtSDK4
     # Replaces this brick with a new one.
     # 
     # IMPORTANT: This operation has been deprecated since version 3.5 of the engine and will be removed in the future.
-    # Use <<services/gluster_bricks/methods/add, add brick(s)>> and
-    # <<services/gluster_bricks/methods/migrate, migrate brick(s)>> instead.
+    # Use xref:services-gluster_bricks-methods-add[add brick(s)] and
+    # xref:services-gluster_bricks-methods-migrate[migrate brick(s)] instead.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -36928,6 +38799,7 @@ module OvirtSDK4
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
+      [:reboot, TrueClass].freeze,
     ].freeze
     
     private_constant :APPROVE
@@ -36949,6 +38821,8 @@ module OvirtSDK4
     # 
     # @option opts [Host] :host The host to approve.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -36993,10 +38867,10 @@ module OvirtSDK4
     # ----
     # 
     # IMPORTANT: Since {engine-name} 4.3, it is possible to also specify `commit_on_success` in
-    # the <<services/host/methods/setup_networks, setupnetworks>> request, in which case the new
+    # the xref:services-host-methods-setup_networks[setupnetworks] request, in which case the new
     # configuration is automatically saved in the {hypervisor-name} upon completing the setup and
     # re-establishing connectivity between the {hypervisor-name} and {engine-name}, and without
-    # waiting for a separate <<services/host/methods/commit_net_config, commitnetconfig>> request.
+    # waiting for a separate xref:services-host-methods-commit_net_config[commitnetconfig] request.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -37025,6 +38899,9 @@ module OvirtSDK4
     # 
     # Copy the network configuration of the specified host to current host.
     # 
+    # IMPORTANT: Any network attachments that are not present on the source host will be erased from the target host
+    # by the copy operation.
+    # 
     # To copy networks from another host, send a request like this:
     # 
     # [source]
@@ -37037,7 +38914,7 @@ module OvirtSDK4
     # [source,xml]
     # ----
     # <action>
-    #    <sourceHost id="456" />
+    #    <source_host id="456"/>
     # </action>
     # ----
     # 
@@ -37093,6 +38970,75 @@ module OvirtSDK4
       internal_action(:deactivate, nil, DEACTIVATE, opts)
     end
     
+    DISCOVER_ISCSI = [
+      [:async, TrueClass].freeze,
+      [:iscsi, IscsiDetails].freeze,
+    ].freeze
+    
+    private_constant :DISCOVER_ISCSI
+    
+    # 
+    # Discovers iSCSI targets on the host, using the initiator details.
+    # Returns a list of IscsiDetails objects containing the discovered data.
+    # 
+    # For example, to discover iSCSI targets available in `myiscsi.example.com`,
+    # from host `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts/123/discoveriscsi
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <iscsi>
+    #     <address>myiscsi.example.com</address>
+    #   </iscsi>
+    # </action>
+    # ----
+    # 
+    # The result will be like this:
+    # 
+    # [source,xml]
+    # ----
+    # <discovered_targets>
+    #   <iscsi_details>
+    #     <address>10.35.1.72</address>
+    #     <port>3260</port>
+    #     <portal>10.35.1.72:3260,1</portal>
+    #     <target>iqn.2015-08.com.tgt:444</target>
+    #   </iscsi_details>
+    # </discovered_targets>
+    # ----
+    # 
+    # IMPORTANT: When using this method to discover iscsi targets, you can use an FQDN or an
+    # IP address, but you must use the iscsi details from the discovered targets results to log in
+    # using the  iscsilogin method.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the discovery should be performed asynchronously.
+    # 
+    # @option opts [Array<IscsiDetails>] :discovered_targets The discovered targets including all connection information.
+    # 
+    # @option opts [IscsiDetails] :iscsi The target iSCSI device.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def discover_iscsi(opts = {})
+      internal_action(:discoveriscsi, :discovered_targets, DISCOVER_ISCSI, opts)
+    end
+    
     ENROLL_CERTIFICATE = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -37278,6 +39224,7 @@ module OvirtSDK4
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
       [:image, String].freeze,
+      [:reboot, TrueClass].freeze,
       [:root_password, String].freeze,
       [:ssh, Ssh].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
@@ -37329,9 +39276,10 @@ module OvirtSDK4
     # --data '
     # {
     #   "root_password": "myrootpassword"
+    # "deploy_hosted_engine" : "true"
     # }
     # ' \
-    # "https://engine.example.com/ovirt-engine/api/hosts/123?deploy_hosted_engine=true"
+    # "https://engine.example.com/ovirt-engine/api/hosts/123"
     # ----
     # 
     # IMPORTANT: Since version 4.1.2 of the engine, when a host is reinstalled we override the host firewall
@@ -37354,6 +39302,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [String] :root_password The password of the `root` user used to connect to the host via SSH.
     # 
     # @option opts [Ssh] :ssh The SSH details used to connect to the host.
@@ -37382,8 +39332,12 @@ module OvirtSDK4
     
     private_constant :ISCSI_DISCOVER
     
+    # 
+    # This method has been deprecated since Engine version 4.4.6.
+    # DiscoverIscsi should be used instead.
     # 
     # Discovers iSCSI targets on the host, using the initiator details.
+    # Returns an array of strings containing the discovered data.
     # 
     # For example, to discover iSCSI targets available in `myiscsi.example.com`,
     # from host `123`, send a request like this:
@@ -37404,32 +39358,14 @@ module OvirtSDK4
     # </action>
     # ----
     # 
-    # The result will be like this:
-    # 
-    # [source,xml]
-    # ----
-    # <discovered_targets>
-    #   <iscsi_details>
-    #     <address>10.35.1.72</address>
-    #     <port>3260</port>
-    #     <portal>10.35.1.72:3260,1</portal>
-    #     <target>iqn.2015-08.com.tgt:444</target>
-    #   </iscsi_details>
-    # </discovered_targets>
-    # ----
-    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the discovery should be performed asynchronously.
     # 
-    # @option opts [Array<IscsiDetails>] :discovered_targets The discovered targets including all connection information.
-    # 
     # @option opts [IscsiDetails] :iscsi The target iSCSI device.
     # 
     # @option opts [Array<String>] :iscsi_targets The iSCSI targets.
-    #   
-    #   Since version 4.2 of the engine, this parameter is deprecated, use
-    #   `discovered_targets` instead.
+    #           *
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -37454,6 +39390,10 @@ module OvirtSDK4
     # 
     # Login to iSCSI targets on the host, using the target details.
     # 
+    # 
+    # IMPORTANT: When using this method to log in, you must use the iscsi details from the
+    # discovered targets results in the discoveriscsi method.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the login should be performed asynchronously.
@@ -37619,8 +39559,8 @@ module OvirtSDK4
     #         <name>bond0</name>
     #       </host_nic>
     #       <ip_address_assignments>
-    #         <assignment_method>static</assignment_method>
     #         <ip_address_assignment>
+    #           <assignment_method>static</assignment_method>
     #           <ip>
     #             <address>192.168.122.10</address>
     #             <netmask>255.255.255.0</netmask>
@@ -37724,13 +39664,13 @@ module OvirtSDK4
     # ----
     # 
     # IMPORTANT: To make sure that the network configuration has been saved in the host, and that it will be applied
-    # when the host is rebooted, remember to call <<services/host/methods/commit_net_config, commitnetconfig>>.
+    # when the host is rebooted, remember to call xref:services-host-methods-commit_net_config[commitnetconfig].
     # 
     # IMPORTANT: Since {engine-name} 4.3, it is possible to also specify `commit_on_success` in
-    # the <<services/host/methods/setup_networks, setupnetworks>> request, in which case the new
+    # the xref:services-host-methods-setup_networks[setupnetworks] request, in which case the new
     # configuration is automatically saved in the {hypervisor-name} upon completing the setup and
     # re-establishing connectivity between the {hypervisor-name} and {engine-name}, and without
-    # waiting for a separate <<services/host/methods/commit_net_config, commitnetconfig>> request.
+    # waiting for a separate xref:services-host-methods-commit_net_config[commitnetconfig] request.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -37740,7 +39680,7 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :commit_on_success Specifies whether to automatically save the configuration in the {hypervisor-name} upon completing
     #   the setup and re-establishing connectivity between the {hypervisor-name} and {engine-name},
-    #   and without waiting for a separate <<services/host/methods/commit_net_config, commitnetconfig>>
+    #   and without waiting for a separate xref:services-host-methods-commit_net_config[commitnetconfig]
     #   request.
     #   The default value is `false`, which means that the configuration will not be
     #   saved automatically.
@@ -37941,7 +39881,7 @@ module OvirtSDK4
     # Check if there are upgrades available for the host. If there are upgrades available an icon will be displayed
     # next to host status icon in the Administration Portal. Audit log messages are also added to indicate the
     # availability of upgrades. The upgrade can be started from the webadmin or by using the
-    # <<services/host/methods/upgrade, upgrade>> host action.
+    # xref:services-host-methods-upgrade[upgrade] host action.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -37963,6 +39903,7 @@ module OvirtSDK4
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
+      [:reboot, TrueClass].freeze,
     ].freeze
     
     private_constant :APPROVE_USING_ROOT_PASSWORD
@@ -37982,6 +39923,8 @@ module OvirtSDK4
     # 
     # @option opts [Host] :host The host to approve.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -38001,6 +39944,7 @@ module OvirtSDK4
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
       [:image, String].freeze,
+      [:reboot, TrueClass].freeze,
       [:root_password, String].freeze,
       [:ssh, Ssh].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
@@ -38029,6 +39973,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [String] :root_password The password of the `root` user used to connect to the host via SSH.
     # 
     # @option opts [Ssh] :ssh The SSH details used to connect to the host.
@@ -38084,6 +40030,7 @@ module OvirtSDK4
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
+      [:reboot, TrueClass].freeze,
     ].freeze
     
     private_constant :APPROVE_USING_SSH
@@ -38104,6 +40051,8 @@ module OvirtSDK4
     # 
     # @option opts [Host] :host The host to approve.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -38123,6 +40072,7 @@ module OvirtSDK4
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
       [:image, String].freeze,
+      [:reboot, TrueClass].freeze,
       [:root_password, String].freeze,
       [:ssh, Ssh].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
@@ -38151,6 +40101,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [String] :root_password The password of the `root` user used to connect to the host via SSH.
     # 
     # @option opts [Ssh] :ssh The SSH details used to connect to the host.
@@ -38210,6 +40162,17 @@ module OvirtSDK4
       @affinity_labels_service ||= AssignedAffinityLabelsService.new(self, 'affinitylabels')
     end
     
+    # 
+    # A reference to the list of all host's CPUs with detailed information
+    # about the topology (socket, core) and with information
+    # about the current CPU pinning.
+    # 
+    # @return [HostCpuUnitsService] A reference to `cpu_units` service.
+    # 
+    def cpu_units_service
+      @cpu_units_service ||= HostCpuUnitsService.new(self, 'cpuunits')
+    end
+    
     # 
     # A reference to the host devices service. Use this service to view the devices of the host object.
     # 
@@ -38357,6 +40320,12 @@ module OvirtSDK4
       if path.start_with?('affinitylabels/')
         return affinity_labels_service.service(path[15..-1])
       end
+      if path == 'cpuunits'
+        return cpu_units_service
+      end
+      if path.start_with?('cpuunits/')
+        return cpu_units_service.service(path[9..-1])
+      end
       if path == 'devices'
         return devices_service
       end