ovirt-engine-sdk 4.4.1 → 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
   
@@ -794,6 +806,12 @@ module OvirtSDK4
   class VmHostDevicesService < Service
   end
   
+  class VmMediatedDeviceService < Service
+  end
+  
+  class VmMediatedDevicesService < Service
+  end
+  
   class VmNicService < MeasurableService
   end
   
@@ -1330,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
     
     # 
@@ -3926,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.
@@ -4871,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]
     # ----
@@ -4896,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.
@@ -5084,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]
     # ----
@@ -5349,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]
     # ----
@@ -5491,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]
@@ -7226,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.
@@ -7653,6 +7693,7 @@ module OvirtSDK4
     LIST = [
       [:follow, String].freeze,
       [:include_active, TrueClass].freeze,
+      [:include_template, TrueClass].freeze,
       [:max, Integer].freeze,
     ].freeze
     
@@ -7670,6 +7711,8 @@ module OvirtSDK4
     # 
     # @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.
@@ -7728,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]
     # ----
@@ -7759,6 +7802,7 @@ module OvirtSDK4
     #   <name>mydisk</name>
     #   <provisioned_size>1048576</provisioned_size>
     #   <format>cow</format>
+    #   <backup>incremental</backup>
     # </disk>
     # ----
     # 
@@ -7806,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:*
     # 
@@ -10248,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 = [
@@ -10265,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]
     # ----
@@ -11144,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:
     # 
@@ -11168,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.
     # 
@@ -11201,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:
@@ -11277,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.
     # 
@@ -11996,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 = [
@@ -15799,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.
@@ -17377,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.
@@ -18905,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:
     # 
@@ -20065,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:
     # 
@@ -21259,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`:
@@ -21433,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.
@@ -22269,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.
     # 
@@ -22419,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).
@@ -22793,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.
@@ -22825,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.
@@ -22886,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.
@@ -22949,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.
@@ -22976,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.
@@ -23004,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.
@@ -23082,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.
@@ -23537,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.
     # 
@@ -23887,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.
     # 
@@ -24182,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
@@ -25530,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.
     # 
@@ -25860,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
@@ -26044,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>
     # ----
     # 
@@ -26097,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>
     #   ----
     # 
@@ -26932,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.
@@ -27180,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.
     # 
@@ -27245,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
@@ -27911,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 = [
@@ -28350,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]
@@ -29026,6 +29457,10 @@ module OvirtSDK4
     # </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.
     # 
@@ -29240,60 +29675,6 @@ module OvirtSDK4
       internal_remove(REMOVE, opts)
     end
     
-    UPDATE = [
-    ].freeze
-    
-    private_constant :UPDATE
-    
-    # 
-    # Replaces an existing property of type JSON with a new one.
-    # 
-    # Example request(for user with identifier `123` and option with identifier `456`):
-    # 
-    # [source]
-    # ----
-    # PUT /ovirt-engine/api/users/123/options/456
-    # ----
-    # 
-    # Payload:
-    # 
-    # [source,xml]
-    # ----
-    # <user_option>
-    #   <name>SomeName</name>
-    #   <content>{"new" : "JSON"}</content>
-    # </user_option>
-    # ----
-    # 
-    # The result will be the following XML document:
-    # 
-    # [source,xml]
-    # ----
-    # <user_option href="/ovirt-engine/api/users/123/options/789" id="789">
-    #   <name>SomeName</name>
-    #   <content>{"new" : "JSON"}</content>
-    #   <user href="/ovirt-engine/api/users/123" id="123"/>
-    # </user_option>
-    # ----
-    # 
-    # @param option [UserOption] The `option` to update.
-    # @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 update(option, opts = {})
-      internal_update(option, UserOption, UPDATE, opts)
-    end
-    
     # 
     # Locates the service corresponding to the given path.
     # 
@@ -29463,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`
@@ -29778,6 +30159,9 @@ module OvirtSDK4
     # 
     # 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]
     # ----
@@ -29898,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.
     # 
@@ -30333,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.
     # 
@@ -30519,6 +30903,87 @@ 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,
@@ -30630,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_.
@@ -30642,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.
     #   
@@ -30871,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]
@@ -30995,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.
     # 
@@ -31130,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.
     # 
@@ -31276,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
@@ -31466,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.
     # 
@@ -31658,6 +32152,7 @@ module OvirtSDK4
     
     ADD = [
       [:require_consistency, TrueClass].freeze,
+      [:use_active, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -31703,6 +32198,26 @@ 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.
@@ -31720,6 +32235,18 @@ module OvirtSDK4
     #   
     #   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.
@@ -31894,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:
     # 
@@ -32260,6 +32787,13 @@ module OvirtSDK4
     # 
     # 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
@@ -32495,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.
     # 
@@ -33204,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]
     # ----
@@ -33216,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.
@@ -33305,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 = [
@@ -33493,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.
     # 
@@ -34077,6 +34842,7 @@ module OvirtSDK4
     
     UPDATE = [
       [:async, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :UPDATE
@@ -34109,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.
@@ -34158,6 +34951,7 @@ module OvirtSDK4
   class VmPoolsService < Service
     
     ADD = [
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -34188,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.
@@ -34810,6 +35632,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -34950,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]
@@ -34976,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:
@@ -35039,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.
@@ -35058,6 +35911,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_CONFIGURATION
@@ -35072,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:
@@ -35135,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.
@@ -35154,6 +36038,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_SCRATCH
@@ -35168,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:
@@ -35231,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.
@@ -35250,6 +36165,7 @@ module OvirtSDK4
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
       [:filter, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_SNAPSHOT
@@ -35264,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:
@@ -35327,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.
@@ -35598,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.
     # 
@@ -35910,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.
@@ -35942,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.
@@ -36003,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.
@@ -36059,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.
@@ -36086,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.
@@ -36114,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.
@@ -36182,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,
@@ -36481,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:
@@ -36585,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.
     # 
@@ -37141,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:
     # 
@@ -37177,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.
     # 
@@ -37865,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.
     # 
@@ -38012,6 +39014,10 @@ module OvirtSDK4
     # </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.
@@ -38384,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.
@@ -38654,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.
     # 
@@ -38670,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.
@@ -38871,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.
     # 
@@ -39152,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.
     # 
@@ -39299,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