ovirt-engine-sdk 4.2.5 → 4.3.0

data/lib/ovirtsdk4/services.rb

@@ -716,6 +716,18 @@ module OvirtSDK4
   class VmApplicationsService < Service
   end
   
+  class VmBackupService < Service
+  end
+  
+  class VmBackupDiskService < Service
+  end
+  
+  class VmBackupDisksService < Service
+  end
+  
+  class VmBackupsService < Service
+  end
+  
   class VmCdromService < Service
   end
   
@@ -4060,7 +4072,7 @@ module OvirtSDK4
     #   <ballooning_enabled>false</ballooning_enabled>
     #   <cpu>
     #     <architecture>x86_64</architecture>
-    #     <type>Intel Penryn Family</type>
+    #     <type>Intel Nehalem Family</type>
     #   </cpu>
     #   <error_handling>
     #     <on_error>migrate</on_error>
@@ -4081,7 +4093,6 @@ module OvirtSDK4
     #     <enabled>true</enabled>
     #     <merge_across_nodes>true</merge_across_nodes>
     #   </ksm>
-    #   <maintenance_reason_required>false</maintenance_reason_required>
     #   <memory_policy>
     #     <over_commit>
     #       <percent>100</percent>
@@ -4097,7 +4108,6 @@ module OvirtSDK4
     #     </bandwidth>
     #     <compressed>inherit</compressed>
     #   </migration>
-    #   <optional_reason>false</optional_reason>
     #   <required_rng_sources>
     #     <required_rng_source>random</required_rng_source>
     #   </required_rng_sources>
@@ -4863,7 +4873,7 @@ module OvirtSDK4
     # <cluster_level id="3.6">
     #   <cpu_types>
     #     <cpu_type>
-    #       <name>Intel Conroe Family</name>
+    #       <name>Intel Nehalem Family</name>
     #       <level>3</level>
     #       <architecture>x86_64</architecture>
     #     </cpu_type>
@@ -5240,7 +5250,7 @@ module OvirtSDK4
     # <cluster>
     #   <name>mycluster</name>
     #   <cpu>
-    #     <type>Intel Penryn Family</type>
+    #     <type>Intel Nehalem Family</type>
     #   </cpu>
     #   <data_center id="123"/>
     # </cluster>
@@ -5261,7 +5271,7 @@ module OvirtSDK4
     # <cluster>
     #   <name>mycluster</name>
     #   <cpu>
-    #     <type>Intel Penryn Family</type>
+    #     <type>Intel Nehalem Family</type>
     #   </cpu>
     #   <data_center id="123"/>
     #   <external_network_providers>
@@ -5565,14 +5575,14 @@ module OvirtSDK4
     # 
     # Returns the list of CPU profiles of the system.
     # 
-    # The order of the returned list of CPU profiles isn't guranteed.
+    # The order of the returned list of CPU profiles is random.
     # 
     # @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 profiles to return. If not specified all the profiles are returned.
+    # @option opts [Integer] :max Sets the maximum number of profiles to return. If not specified, all the profiles are returned.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -8781,7 +8791,7 @@ module OvirtSDK4
     private_constant :ADD
     
     # 
-    # Adds a new external host provider to the system.
+    # Add a new external host provider to the system.
     # 
     # @param provider [ExternalHostProvider] The `provider` to add.
     # 
@@ -8813,14 +8823,14 @@ module OvirtSDK4
     # 
     # Returns the list of external host providers.
     # 
-    # The order of the returned list of host providers is not guaranteed.
+    # The order of the returned list of host providers 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 providers to return. If not specified, all the providers are returned.
+    # @option opts [Integer] :max Sets the maximum number of providers to return. If not specified all the providers are returned.
     # 
     # @option opts [String] :search A query string used to restrict the returned external host providers.
     # 
@@ -11159,14 +11169,14 @@ module OvirtSDK4
     # 
     # Returns the list of hooks configured for the host.
     # 
-    # The order of the returned list of hooks isn't guranteed.
+    # The order of the returned list of hooks is random.
     # 
     # @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 hooks to return. If not specified all the hooks are returned.
+    # @option opts [Integer] :max Sets the maximum number of hooks to return. If not specified, all the hooks are returned.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -11483,6 +11493,7 @@ module OvirtSDK4
   class HostsService < Service
     
     ADD = [
+      [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
@@ -11492,10 +11503,10 @@ module OvirtSDK4
     # 
     # Creates a new host.
     # 
-    # The host is created based on the attributes of the `host` parameter. The `name`, `address` and `root_password`
+    # The host is created based on the attributes of the `host` parameter. The `name`, `address`, and `root_password`
     # properties are required.
     # 
-    # For example, to add a host send the following request:
+    # For example, to add a host, send the following request:
     # 
     # [source]
     # ----
@@ -11516,8 +11527,8 @@ module OvirtSDK4
     # NOTE: The `root_password` element is only included in the client-provided initial representation and is not
     # exposed in the representations returned from subsequent requests.
     # 
-    # IMPORTANT: Since version 4.1.2 of the engine when a host is newly added we override the host firewall
-    # definitions by default.
+    # IMPORTANT: Since version 4.1.2 of the engine, when a host is newly added, the host's firewall
+    # definitions are overridden by default.
     # 
     # To add a hosted engine host, use the optional `deploy_hosted_engine` parameter:
     # 
@@ -11526,11 +11537,11 @@ module OvirtSDK4
     # POST /ovirt-engine/api/hosts?deploy_hosted_engine=true
     # ----
     # 
-    # If the cluster has a default external network provider which is supported for automatic deployment,
+    # If the cluster has a default external network provider that is supported for automatic deployment,
     # the external network provider is deployed when adding the host.
     # Only external network providers for OVN are supported for the automatic deployment.
-    # To deploy an external network provider that differs to what is defined in the clusters, overwrite the external
-    # network provider when adding hosts by sending a request like this:
+    # To deploy an external network provider other than the one defined in the clusters, overwrite the external
+    # network provider when adding hosts, by sending the following request:
     # 
     # [source]
     # ----
@@ -11554,18 +11565,22 @@ module OvirtSDK4
     # </host>
     # ----
     # 
-    # @param host [Host] The host definition from which to create the new host is passed as parameter, and the newly created host
+    # @param host [Host] The host definition with which the new host is created is passed as a parameter, and the newly created host
     #   is returned.
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should deploy also hosted engine components. Missing value is treated
-    #   as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in hosted engine
-    #   area.
+    # @option opts [Boolean] :activate When set to `true`, this host will be activated after its installation completes. When set to `false`
+    #   the host will remain in `maintenance` status after its installation. Absence of this parameter will be
+    #   interpreted as `true`, since the desired default behavior is activating the host after install.
+    # 
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true`, this host deploys the hosted engine components. A missing value is treated
+    #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
+    #   the host performs no operation in the hosted engine area.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy hosted engine components and this host will not
-    #   function as part of the High Availability cluster. Missing value is treated as `true` i.e un-deploy.
-    #   Omitting this parameter means `false` and will perform no operation in hosted engine area.
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
+    #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
+    #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -11588,6 +11603,7 @@ module OvirtSDK4
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
       [:max, Integer].freeze,
+      [:migration_target_of, String].freeze,
       [:search, String].freeze,
     ].freeze
     
@@ -11602,7 +11618,7 @@ module OvirtSDK4
     # GET /ovirt-engine/api/hosts
     # ....
     # 
-    # The response body will be something like this:
+    # The response body will be similar to this:
     # 
     # [source,xml]
     # ----
@@ -11649,6 +11665,16 @@ module OvirtSDK4
     # 
     # @option opts [Integer] :max Sets the maximum number of hosts to return. If not specified all the hosts are returned.
     # 
+    # @option opts [String] :migration_target_of Accepts a comma-separated list of virtual machine IDs and returns the hosts
+    #   that these virtual machines can be migrated to.
+    #   
+    #   For example, to retrieve the list of hosts to which the virtual machine with ID 123 and
+    #   the virtual machine with ID 456 can be migrated to, send the following request:
+    #   
+    #   ....
+    #   GET /ovirt-engine/api/hosts?migration_target_of=123,456
+    #   ....
+    # 
     # @option opts [String] :search A query string used to restrict the returned hosts.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -11667,6 +11693,7 @@ module OvirtSDK4
     end
     
     ADD_USING_ROOT_PASSWORD = [
+      [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
@@ -11676,18 +11703,22 @@ module OvirtSDK4
     # 
     # Add a new host to the system providing the host root password. This has been deprecated and provided for backwards compatibility.
     # 
-    # @param host [Host] The host definition from which to create the new host is passed as parameter, and the newly created host
+    # @param host [Host] The host definition with which the new host is created is passed as a parameter, and the newly created host
     #   is returned.
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should deploy also hosted engine components. Missing value is treated
-    #   as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in hosted engine
-    #   area.
+    # @option opts [Boolean] :activate When set to `true`, this host will be activated after its installation completes. When set to `false`
+    #   the host will remain in `maintenance` status after its installation. Absence of this parameter will be
+    #   interpreted as `true`, since the desired default behavior is activating the host after install.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy hosted engine components and this host will not
-    #   function as part of the High Availability cluster. Missing value is treated as `true` i.e un-deploy.
-    #   Omitting this parameter means `false` and will perform no operation in hosted engine area.
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true`, this host deploys the hosted engine components. A missing value is treated
+    #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
+    #   the host performs no operation in the hosted engine area.
+    # 
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
+    #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
+    #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -11705,6 +11736,7 @@ module OvirtSDK4
     end
     
     ADD_USING_SSH = [
+      [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
@@ -11714,18 +11746,22 @@ module OvirtSDK4
     # 
     # Add a new host to the system providing the ssh password or fingerprint.
     # 
-    # @param host [Host] The host definition from which to create the new host is passed as parameter, and the newly created host
+    # @param host [Host] The host definition with which the new host is created is passed as a parameter, and the newly created host
     #   is returned.
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should deploy also hosted engine components. Missing value is treated
-    #   as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in hosted engine
-    #   area.
+    # @option opts [Boolean] :activate When set to `true`, this host will be activated after its installation completes. When set to `false`
+    #   the host will remain in `maintenance` status after its installation. Absence of this parameter will be
+    #   interpreted as `true`, since the desired default behavior is activating the host after install.
+    # 
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true`, this host deploys the hosted engine components. A missing value is treated
+    #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
+    #   the host performs no operation in the hosted engine area.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy hosted engine components and this host will not
-    #   function as part of the High Availability cluster. Missing value is treated as `true` i.e un-deploy.
-    #   Omitting this parameter means `false` and will perform no operation in hosted engine area.
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
+    #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
+    #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -14756,6 +14792,8 @@ module OvirtSDK4
     # </network>
     # ----
     # 
+    # NOTE: Updating external networks is not propagated to the provider.
+    # 
     # @param network [Network] The `network` to update.
     # @param opts [Hash] Additional options.
     # 
@@ -16057,7 +16095,7 @@ module OvirtSDK4
     private_constant :ADD
     
     # 
-    # Adds a new OpenStack image provider to the system.
+    # Add a new OpenStack image provider to the system.
     # 
     # @param provider [OpenStackImageProvider] The `provider` to add.
     # 
@@ -16089,14 +16127,14 @@ module OvirtSDK4
     # 
     # Returns the list of providers.
     # 
-    # The order of the returned list of providers is not guaranteed.
+    # The order of the returned list of providers 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 providers to return. If not specified, all the providers are returned.
+    # @option opts [Integer] :max Sets the maximum number of providers to return. If not specified all the providers are returned.
     # 
     # @option opts [String] :search A query string used to restrict the returned OpenStack image providers.
     # 
@@ -16545,7 +16583,7 @@ module OvirtSDK4
     private_constant :ADD
     
     # 
-    # Adds a new network provider to the system.
+    # The operation adds a new network provider to the system.
     # If the `type` property is not present, a default value of `NEUTRON` will be used.
     # 
     # @param provider [OpenStackNetworkProvider] The `provider` to add.
@@ -16578,14 +16616,14 @@ module OvirtSDK4
     # 
     # Returns the list of providers.
     # 
-    # The order of the returned list of providers is not guaranteed.
+    # The order of the returned list of providers 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 providers to return. If not specified, all the providers are returned.
+    # @option opts [Integer] :max Sets the maximum number of providers to return. If not specified all the providers are returned.
     # 
     # @option opts [String] :search A query string used to restrict the returned OpenStack network providers.
     # 
@@ -16605,7 +16643,7 @@ module OvirtSDK4
     end
     
     # 
-    # Reference to the OpenStack network provider service.
+    # Reference to OpenStack network provider service.
     # 
     # @param id [String] The identifier of the `provider`.
     # 
@@ -17333,14 +17371,14 @@ module OvirtSDK4
     # 
     # Retrieves the list of volume providers.
     # 
-    # The order of the returned list of volume providers is not guaranteed.
+    # The order of the returned list of volume providers 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 providers to return. If not specified, all the providers are returned.
+    # @option opts [Integer] :max Sets the maximum number of providers to return. If not specified all the providers are returned.
     # 
     # @option opts [String] :search A query string used to restrict the returned volume providers.
     # 
@@ -27218,6 +27256,20 @@ module OvirtSDK4
     # </template>
     # ----
     # 
+    # Since version 4.3, in order to create virtual machine template from a snapshot send a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <template>
+    #   <name>mytemplate</name>
+    #   <vm id="123">
+    #     <snapshots>
+    #       <snapshot id="456"/>
+    #     </snapshots>
+    #   </vm>
+    # </template>
+    # ----
+    # 
     # The disks of the template can be customized, making some of their characteristics different from the disks of the
     # 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
@@ -27488,6 +27540,70 @@ module OvirtSDK4
       internal_add(template, Template, ADD_FROM_VM, opts)
     end
     
+    ADD_FROM_VM_SNAPSHOT = [
+      [:clone_permissions, TrueClass].freeze,
+      [:seal, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :ADD_FROM_VM_SNAPSHOT
+    
+    # 
+    # Add a virtual machine template to the system from a snapshot.
+    # 
+    # @param template [Template] The information about the template or template version.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :clone_permissions Specifies if the permissions of the virtual machine should be copied to the template.
+    #   
+    #   If this optional parameter is provided, and its value is `true`, then the permissions of the virtual machine
+    #   (only the direct ones, not the inherited ones) will be copied to the created template. For example, to create
+    #   a template from the `myvm` virtual machine copying its permissions, send a request like this:
+    #   
+    #   [source]
+    #   ----
+    #   POST /ovirt-engine/api/templates?clone_permissions=true
+    #   ----
+    #   
+    #   With a request body like this:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <template>
+    #     <name>mytemplate<name>
+    #     <vm>
+    #       <name>myvm<name>
+    #     </vm>
+    #   </template>
+    #   ----
+    # 
+    # @option opts [Boolean] :seal Seals the template.
+    #   
+    #   If this optional parameter is provided and its value is `true`,
+    #   then the template is sealed after creation.
+    #   
+    #   Sealing erases all host-specific configuration from the filesystem:
+    #   SSH keys, UDEV rules, MAC addresses, system ID, hostname, and so on,
+    #   thus making it easier to use the template to create multiple virtual
+    #   machines without manual intervention.
+    #   
+    #   Currently, sealing is supported only for Linux operating systems.
+    # 
+    # @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 [Template]
+    # 
+    def add_from_vm_snapshot(template, opts = {})
+      internal_add(template, Template, ADD_FROM_VM_SNAPSHOT, opts)
+    end
+    
     LIST = [
       [:case_sensitive, TrueClass].freeze,
       [:filter, TrueClass].freeze,
@@ -29377,6 +29493,15 @@ module OvirtSDK4
       @applications_service ||= VmApplicationsService.new(self, 'applications')
     end
     
+    # 
+    # List of backups of this virtual machine.
+    # 
+    # @return [VmBackupsService] A reference to `backups` service.
+    # 
+    def backups_service
+      @backups_service ||= VmBackupsService.new(self, 'backups')
+    end
+    
     # 
     # Locates the `cdroms` service.
     # 
@@ -29527,6 +29652,12 @@ module OvirtSDK4
       if path.start_with?('applications/')
         return applications_service.service(path[13..-1])
       end
+      if path == 'backups'
+        return backups_service
+      end
+      if path.start_with?('backups/')
+        return backups_service.service(path[8..-1])
+      end
       if path == 'cdroms'
         return cdroms_service
       end
@@ -29736,6 +29867,336 @@ module OvirtSDK4
     
   end
   
+  class VmBackupService < Service
+    
+    FINALIZE = [
+    ].freeze
+    
+    private_constant :FINALIZE
+    
+    # 
+    # Finalize the virtual machine backup entity.
+    # 
+    # End backup, unlock resources, and perform cleanups.
+    # 
+    # @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 finalize(opts = {})
+      internal_action(:finalize, nil, FINALIZE, opts)
+    end
+    
+    GET = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Returns information about the virtual machine backup.
+    # 
+    # @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 [Backup]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    # 
+    # A reference to the service that lists the disks in backup.
+    # 
+    # @return [VmBackupDisksService] A reference to `disks` service.
+    # 
+    def disks_service
+      @disks_service ||= VmBackupDisksService.new(self, 'disks')
+    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
+      if path == 'disks'
+        return disks_service
+      end
+      if path.start_with?('disks/')
+        return disks_service.service(path[6..-1])
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class VmBackupDiskService < Service
+    
+    GET = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Retrieves the description of the disk.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Disk]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class VmBackupDisksService < Service
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Returns the list of disks in backup.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of disks to return. If not specified, all the disks are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<Disk>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # A reference to the service that manages a specific disk.
+    # 
+    # @param id [String] The identifier of the `disk`.
+    # 
+    # @return [VmBackupDiskService] A reference to the `disk` service.
+    # 
+    def disk_service(id)
+      VmBackupDiskService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return disk_service(path)
+      end
+      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+    end
+    
+  end
+  
+  class VmBackupsService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Adds a new backup entity to a virtual machine.
+    # 
+    # For example, to start a new incremental backup of a virtual machine
+    # since checkpoint id `previous-checkpoint-uuid`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/backups
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # POST /ovirt-engine/api/vms/123/backups
+    # <backup>
+    #   <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
+    #   <disks>
+    #       <disk id="disk-uuid" />
+    #       ...
+    #   </disks>
+    # </backup>
+    # ----
+    # 
+    # The response body:
+    # 
+    # [source,xml]
+    # ----
+    # <backup id="backup-uuid">
+    #     <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
+    #     <to_checkpoint_id>new-checkpoint-uuid</to_checkpoint_id>
+    #     <disks>
+    #         <disk id="disk-uuid" />
+    #         ...
+    #         ...
+    #     </disks>
+    #     <status>initializing</status>
+    #     <creation_date>
+    # </backup>
+    # ----
+    # 
+    # @param backup [Backup] The information about the virtual machine backup entity.
+    # 
+    # @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 [Backup]
+    # 
+    def add(backup, opts = {})
+      internal_add(backup, Backup, ADD, opts)
+    end
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # The list of virtual machine backups.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of virtual machine backups to return. If not specified, all the virtual machine backups 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<Backup>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Returns a reference to the service that manages a specific VM backup.
+    # 
+    # @param id [String] The identifier of the `backup`.
+    # 
+    # @return [VmBackupService] A reference to the `backup` service.
+    # 
+    def backup_service(id)
+      VmBackupService.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 backup_service(path)
+      end
+      return backup_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+    end
+    
+  end
+  
   class VmCdromService < Service
     
     GET = [
@@ -32479,6 +32940,7 @@ module OvirtSDK4
     ADD = [
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
+      [:filter, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -32699,6 +33161,15 @@ module OvirtSDK4
     #   </vm>
     #   ----
     # 
+    # @option opts [Boolean] :filter Relevant for admin users only. Indicates whether to assign UserVmManager role
+    #   on the created Virtual Machine for this user. This will enable the user to later access
+    #   the Virtual Machine as though he were a non-admin user, foregoing his admin permissions
+    #   (by providing filter=true).
+    #   
+    #   NOTE: admin-as-user (meaning providing filter=true) POST requests on an existing Virtual
+    #   Machine will fail unless the Virtual Machine has been previously created by the admin as
+    #   a user (meaning with filter=true).
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -32717,6 +33188,7 @@ module OvirtSDK4
     ADD_FROM_CONFIGURATION = [
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
+      [:filter, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_CONFIGURATION
@@ -32785,6 +33257,15 @@ module OvirtSDK4
     #   </vm>
     #   ----
     # 
+    # @option opts [Boolean] :filter Relevant for admin users only. Indicates whether to assign UserVmManager role
+    #   on the created Virtual Machine for this user. This will enable the user to later access
+    #   the Virtual Machine as though he were a non-admin user, foregoing his admin permissions
+    #   (by providing filter=true).
+    #   
+    #   NOTE: admin-as-user (meaning providing filter=true) POST requests on an existing Virtual
+    #   Machine will fail unless the Virtual Machine has been previously created by the admin as
+    #   a user (meaning with filter=true).
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -32803,6 +33284,7 @@ module OvirtSDK4
     ADD_FROM_SCRATCH = [
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
+      [:filter, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_SCRATCH
@@ -32871,6 +33353,15 @@ module OvirtSDK4
     #   </vm>
     #   ----
     # 
+    # @option opts [Boolean] :filter Relevant for admin users only. Indicates whether to assign UserVmManager role
+    #   on the created Virtual Machine for this user. This will enable the user to later access
+    #   the Virtual Machine as though he were a non-admin user, foregoing his admin permissions
+    #   (by providing filter=true).
+    #   
+    #   NOTE: admin-as-user (meaning providing filter=true) POST requests on an existing Virtual
+    #   Machine will fail unless the Virtual Machine has been previously created by the admin as
+    #   a user (meaning with filter=true).
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -32889,6 +33380,7 @@ module OvirtSDK4
     ADD_FROM_SNAPSHOT = [
       [:clone, TrueClass].freeze,
       [:clone_permissions, TrueClass].freeze,
+      [:filter, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_FROM_SNAPSHOT
@@ -32957,6 +33449,15 @@ module OvirtSDK4
     #   </vm>
     #   ----
     # 
+    # @option opts [Boolean] :filter Relevant for admin users only. Indicates whether to assign UserVmManager role
+    #   on the created Virtual Machine for this user. This will enable the user to later access
+    #   the Virtual Machine as though he were a non-admin user, foregoing his admin permissions
+    #   (by providing filter=true).
+    #   
+    #   NOTE: admin-as-user (meaning providing filter=true) POST requests on an existing Virtual
+    #   Machine will fail unless the Virtual Machine has been previously created by the admin as
+    #   a user (meaning with filter=true).
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -33815,7 +34316,7 @@ module OvirtSDK4
     # 
     # This operation copies a disk to the specified storage domain.
     # 
-    # For example, copy of a disk can be facilitated using the following request:
+    # For example, a disk can be copied using the following request:
     # 
     # [source]
     # ----
@@ -33834,10 +34335,10 @@ module OvirtSDK4
     # </action>
     # ----
     # 
-    # If the disk profile or the quota used currently by the disk aren't defined for the new storage domain, then they
-    # can be explicitly specified. If they aren't then the first available disk profile and the default quota are used.
+    # If the disk profile or the quota currently used by the disk are not defined for the new storage domain, they
+    # can be explicitly specified. If they are not specified, the first available disk profile and the default quota are used.
     # 
-    # For example, to explicitly use disk profile `987` and quota `753` send a request body like this:
+    # For example, to specify disk profile `987` and quota `753`, send a request body like this:
     # 
     # [source,xml]
     # ----
@@ -33870,8 +34371,8 @@ module OvirtSDK4
     #   If this parameter is not used and the old quota is not defined for the new storage domain,
     #   the default (unlimited) quota will be assigned to the disk.
     # 
-    # @option opts [StorageDomain] :storage_domain The storage domain where the new disk will be created. Can be specified using the `id` or `name`
-    #   attributes. For example, to copy a disk to the storage domain named `mydata` send a request like this:
+    # @option opts [StorageDomain] :storage_domain The storage domain where the new disk is created. This can be specified using the `id` or `name`
+    #   attributes. For example, to copy a disk to the storage domain called `mydata`, send a request like this:
     #   
     #   ....
     #   POST /ovirt-engine/api/storagedomains/123/disks/789
@@ -33918,7 +34419,7 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
     # 
-    # @option opts [StorageDomain] :storage_domain 
+    # @option opts [StorageDomain] :storage_domain The export storage domain where the disk will be exported to.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -34043,7 +34544,7 @@ module OvirtSDK4
     #   If this parameter is not used and the old quota is not defined for the new storage domain,
     #   the default (unlimited) quota will be assigned to the disk.
     # 
-    # @option opts [StorageDomain] :storage_domain 
+    # @option opts [StorageDomain] :storage_domain The storage domain where the disk will be moved to.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -34199,7 +34700,7 @@ module OvirtSDK4
     # This operation updates the disk with the appropriate parameters.
     # The only field that can be updated is `qcow_version`.
     # 
-    # For example, update disk can be facilitated using the following request:
+    # For example, disk update can be done using the following request:
     # 
     # [source]
     # ----
@@ -34215,7 +34716,7 @@ module OvirtSDK4
     # </disk>
     # ----
     # 
-    # Since the backend operation is asynchronous the disk element which will be returned
+    # Since the backend operation is asynchronous, the disk element that is returned
     # to the user might not be synced with the changed properties.
     # 
     # @param disk [Disk] The update to apply to the disk.
@@ -35375,6 +35876,7 @@ module OvirtSDK4
     end
     
     APPROVE = [
+      [:activate, TrueClass].freeze,
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
@@ -35389,6 +35891,10 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :activate When set to 'true', this host will be activated after its approval completes. When set to 'false'
+    #   the host will remain in 'maintenance' status after its approval. Absence of this parameter will be
+    #   interpreted as 'true', since the desired default behavior is activating the host after approval.
+    # 
     # @option opts [Boolean] :async Indicates if the approval should be performed asynchronously.
     # 
     # @option opts [Cluster] :cluster The cluster where the host will be added after it is approved.
@@ -35438,6 +35944,12 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # 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
+    # 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.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
@@ -35665,6 +36177,7 @@ module OvirtSDK4
     end
     
     INSTALL = [
+      [:activate, TrueClass].freeze,
       [:async, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
@@ -35730,6 +36243,10 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :activate When set to 'true', this host will be activated after its installation completes. When set to 'false'
+    #   the host will remain in 'maintenance' status after its installation. Absence of this parameter will be
+    #   interpreted as 'true', since the desired default behavior is activating the host after install.
+    # 
     # @option opts [Boolean] :async Indicates if the installation should be performed asynchronously.
     # 
     # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should also deploy the self-hosted engine components. A missing value
@@ -35931,6 +36448,7 @@ module OvirtSDK4
     SETUP_NETWORKS = [
       [:async, TrueClass].freeze,
       [:check_connectivity, TrueClass].freeze,
+      [:commit_on_success, TrueClass].freeze,
       [:connectivity_timeout, Integer].freeze,
       [:modified_bonds, List].freeze,
       [:modified_labels, List].freeze,
@@ -36109,12 +36627,25 @@ 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>>.
     # 
+    # 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
+    # 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.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
     # @option opts [Boolean] :check_connectivity 
     # 
+    # @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>>
+    #   request.
+    #   The default value is `false`, which means that the configuration will not be
+    #   saved automatically.
+    # 
     # @option opts [Integer] :connectivity_timeout 
     # 
     # @option opts [Array<HostNic>] :modified_bonds 
@@ -36324,6 +36855,7 @@ module OvirtSDK4
     end
     
     APPROVE_USING_ROOT_PASSWORD = [
+      [:activate, TrueClass].freeze,
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
@@ -36332,11 +36864,14 @@ module OvirtSDK4
     private_constant :APPROVE_USING_ROOT_PASSWORD
     
     # 
-    # Approve the specified host to be added to the engine by using the root password (deprecated verb). This
-    # occurs when the host registers itself with the engine.
+    # Executes the `approve_using_root_password` method.
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :activate When set to 'true', this host will be activated after its approval completes. When set to 'false'
+    #   the host will remain in 'maintenance' status after its approval. Absence of this parameter will be
+    #   interpreted as 'true', since the desired default behavior is activating the host after approval.
+    # 
     # @option opts [Boolean] :async Indicates if the approval should be performed asynchronously.
     # 
     # @option opts [Cluster] :cluster The cluster where the host will be added after it is approved.
@@ -36357,6 +36892,7 @@ module OvirtSDK4
     end
     
     INSTALL_USING_ROOT_PASSWORD = [
+      [:activate, TrueClass].freeze,
       [:async, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
@@ -36374,6 +36910,10 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :activate When set to 'true', this host will be activated after its installation completes. When set to 'false'
+    #   the host will remain in 'maintenance' status after its installation. Absence of this parameter will be
+    #   interpreted as 'true', since the desired default behavior is activating the host after install.
+    # 
     # @option opts [Boolean] :async Indicates if the installation should be performed asynchronously.
     # 
     # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should also deploy the self-hosted engine components. A missing value
@@ -36436,6 +36976,7 @@ module OvirtSDK4
     end
     
     APPROVE_USING_SSH = [
+      [:activate, TrueClass].freeze,
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
@@ -36449,6 +36990,10 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :activate When set to 'true', this host will be activated after its approval completes. When set to 'false'
+    #   the host will remain in 'maintenance' status after its approval. Absence of this parameter will be
+    #   interpreted as 'true', since the desired default behavior is activating the host after approval.
+    # 
     # @option opts [Boolean] :async Indicates if the approval should be performed asynchronously.
     # 
     # @option opts [Cluster] :cluster The cluster where the host will be added after it is approved.
@@ -36469,6 +37014,7 @@ module OvirtSDK4
     end
     
     INSTALL_USING_SSH = [
+      [:activate, TrueClass].freeze,
       [:async, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
@@ -36486,6 +37032,10 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :activate When set to 'true', this host will be activated after its installation completes. When set to 'false'
+    #   the host will remain in 'maintenance' status after its installation. Absence of this parameter will be
+    #   interpreted as 'true', since the desired default behavior is activating the host after install.
+    # 
     # @option opts [Boolean] :async Indicates if the installation should be performed asynchronously.
     # 
     # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should also deploy the self-hosted engine components. A missing value