ovirt-engine-sdk 4.4.0 → 4.4.1

data/lib/ovirtsdk4/services.rb

@@ -722,6 +722,12 @@ module OvirtSDK4
   class UserService < Service
   end
   
+  class UserOptionService < Service
+  end
+  
+  class UserOptionsService < Service
+  end
+  
   class UsersService < Service
   end
   
@@ -758,6 +764,18 @@ module OvirtSDK4
   class VmCdromsService < Service
   end
   
+  class VmCheckpointService < Service
+  end
+  
+  class VmCheckpointDiskService < Service
+  end
+  
+  class VmCheckpointDisksService < Service
+  end
+  
+  class VmCheckpointsService < Service
+  end
+  
   class VmDiskService < MeasurableService
   end
   
@@ -6240,6 +6258,48 @@ module OvirtSDK4
   
   class DataCenterService < Service
     
+    CLEAN_FINISHED_TASKS = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :CLEAN_FINISHED_TASKS
+    
+    # 
+    # Currently, the storage pool manager (SPM) fails to
+    # switch to another host if the SPM has uncleared tasks.
+    # Clearing all finished tasks enables the SPM switching.
+    # 
+    # For example, to clean all the finished tasks on a data center with ID `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/cleanfinishedtasks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def clean_finished_tasks(opts = {})
+      internal_action(:cleanfinishedtasks, nil, CLEAN_FINISHED_TASKS, opts)
+    end
+    
     GET = [
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
@@ -6352,6 +6412,53 @@ module OvirtSDK4
       internal_remove(REMOVE, opts)
     end
     
+    SET_MASTER = [
+      [:async, TrueClass].freeze,
+      [:storage_domain, StorageDomain].freeze,
+    ].freeze
+    
+    private_constant :SET_MASTER
+    
+    # 
+    # Used for manually setting a storage domain in the data center as a master.
+    # For example, for setting a storage domain with ID '456' as a master on a data center with ID '123',
+    # send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/setmaster
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain id="456"/>
+    # </action>
+    # ----
+    # 
+    # The new master storage domain can be also specified by its name.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
+    # 
+    # @option opts [StorageDomain] :storage_domain The new master storage domain for the data center.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def set_master(opts = {})
+      internal_action(:setmaster, nil, SET_MASTER, opts)
+    end
+    
     UPDATE = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -7545,6 +7652,7 @@ module OvirtSDK4
     
     LIST = [
       [:follow, String].freeze,
+      [:include_active, TrueClass].freeze,
       [:max, Integer].freeze,
     ].freeze
     
@@ -7560,6 +7668,8 @@ module OvirtSDK4
     # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
     #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
     # 
+    # @option opts [Boolean] :include_active If true return also active snapshots. If not specified active snapshots are not returned.
+    # 
     # @option opts [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.
@@ -12421,6 +12531,7 @@ module OvirtSDK4
     ADD = [
       [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
+      [:reboot, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
     
@@ -12504,6 +12615,8 @@ module OvirtSDK4
     #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
     #   the host performs no operation in the hosted engine area.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
     #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
     #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
@@ -12636,6 +12749,7 @@ module OvirtSDK4
     ADD_USING_ROOT_PASSWORD = [
       [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
+      [:reboot, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
     
@@ -12657,6 +12771,8 @@ module OvirtSDK4
     #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
     #   the host performs no operation in the hosted engine area.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
     #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
     #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
@@ -12679,13 +12795,14 @@ module OvirtSDK4
     ADD_USING_SSH = [
       [:activate, TrueClass].freeze,
       [:deploy_hosted_engine, TrueClass].freeze,
+      [:reboot, TrueClass].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD_USING_SSH
     
     # 
-    # Add a new host to the system providing the ssh password or fingerprint.
+    # Add a new host to the system providing the ssh password, fingerprint or public key.
     # 
     # @param host [Host] The host definition with which the new host is created is passed as a parameter, and the newly created host
     #   is returned.
@@ -12700,6 +12817,8 @@ module OvirtSDK4
     #   as `true`, i.e., deploy the hosted engine components. Omitting this parameter equals `false`, and
     #   the host performs no operation in the hosted engine area.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Boolean] :undeploy_hosted_engine When set to `true`, this host un-deploys the hosted engine components and does not
     #   function as part of the High Availability cluster. A missing value is treated as `true`, i.e., un-deploy.
     #   Omitting this parameter equals `false` and the host performs no operation in the hosted engine area.
@@ -15366,6 +15485,15 @@ module OvirtSDK4
       internal_update(pool, MacPool, UPDATE, opts)
     end
     
+    # 
+    # Returns a reference to the service that manages the permissions that are associated with the MacPool.
+    # 
+    # @return [AssignedPermissionsService] A reference to `permissions` service.
+    # 
+    def permissions_service
+      @permissions_service ||= AssignedPermissionsService.new(self, 'permissions')
+    end
+    
     # 
     # Locates the service corresponding to the given path.
     # 
@@ -15377,6 +15505,12 @@ module OvirtSDK4
       if path.nil? || path == ''
         return self
       end
+      if path == 'permissions'
+        return permissions_service
+      end
+      if path.start_with?('permissions/')
+        return permissions_service.service(path[12..-1])
+      end
       raise Error.new("The path \"#{path}\" doesn't correspond to any service")
     end
     
@@ -20623,6 +20757,7 @@ module OvirtSDK4
     # ----
     # <action/>
     # ----
+    # NOTE: Confirm that the commit operation is finished and the virtual machine is down before running the virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28885,7 +29020,7 @@ module OvirtSDK4
     #    <user_options>
     #       <property>
     #          <name>test</name>
-    #          <value>test1</value>
+    #          <value>["any","JSON"]</value>
     #       </property>
     #    </user_options>
     # </user>
@@ -28927,6 +29062,15 @@ module OvirtSDK4
       @groups_service ||= DomainUserGroupsService.new(self, 'groups')
     end
     
+    # 
+    # Locates the `options` service.
+    # 
+    # @return [UserOptionsService] A reference to `options` service.
+    # 
+    def options_service
+      @options_service ||= UserOptionsService.new(self, 'options')
+    end
+    
     # 
     # Locates the `permissions` service.
     # 
@@ -28986,6 +29130,12 @@ module OvirtSDK4
       if path.start_with?('groups/')
         return groups_service.service(path[7..-1])
       end
+      if path == 'options'
+        return options_service
+      end
+      if path.start_with?('options/')
+        return options_service.service(path[8..-1])
+      end
       if path == 'permissions'
         return permissions_service
       end
@@ -29015,6 +29165,273 @@ module OvirtSDK4
     
   end
   
+  class UserOptionService < Service
+    
+    GET = [
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Returns a user profile property of type JSON.
+    # 
+    # Example request(for user with identifier `123` and option with identifier `456`):
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/users/123/options/456
+    # ----
+    # 
+    # The result will be the following XML document:
+    # 
+    # [source,xml]
+    # ----
+    #   <user_option href="/ovirt-engine/api/users/123/options/456" id="456">
+    #     <name>SomeName</name>
+    #     <content>["any", "JSON"]</content>
+    #     <user href="/ovirt-engine/api/users/123" id="123"/>
+    #   </user_option>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [UserOption]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    REMOVE = [
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Deletes an existing property of type JSON.
+    # 
+    # Example request(for user with identifier `123` and option with identifier `456`):
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/users/123/options/456
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def remove(opts = {})
+      internal_remove(REMOVE, opts)
+    end
+    
+    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.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+  end
+  
+  class UserOptionsService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Adds a new user profile property of type JSON.
+    # 
+    # Example request(for user with identifier `123`):
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/users/123/options
+    # ----
+    # 
+    # Payload:
+    # 
+    # [source,xml]
+    # ----
+    #   <user_option>
+    #     <name>SomeName</name>
+    #     <content>["any", "JSON"]</content>
+    #   </user_option>
+    # ----
+    # 
+    # @param option [UserOption] The `option` to add.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [UserOption]
+    # 
+    def add(option, opts = {})
+      internal_add(option, UserOption, ADD, opts)
+    end
+    
+    LIST = [
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Returns a list of user profile properties of type JSON.
+    # 
+    # Example request(for user with identifier `123`):
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/users/123/options
+    # ----
+    # 
+    # The result will be the following XML document:
+    # 
+    # [source,xml]
+    # ----
+    # <user_options>
+    #   <user_option href="/ovirt-engine/api/users/123/options/456" id="456">
+    #     <name>SomeName</name>
+    #     <content>["any", "JSON"]</content>
+    #     <user href="/ovirt-engine/api/users/123" id="123"/>
+    #   </user_option>
+    # </user_options>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<UserOption>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Locates the `option` service.
+    # 
+    # @param id [String] The identifier of the `option`.
+    # 
+    # @return [UserOptionService] A reference to the `option` service.
+    # 
+    def option_service(id)
+      UserOptionService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return option_service(path)
+      end
+      return option_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
   class UsersService < Service
     
     ADD = [
@@ -29351,6 +29768,52 @@ module OvirtSDK4
   
   class VmService < MeasurableService
     
+    AUTO_PIN_CPU_AND_NUMA_NODES = [
+      [:async, TrueClass].freeze,
+      [:optimize_cpu_settings, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :AUTO_PIN_CPU_AND_NUMA_NODES
+    
+    # 
+    # Apply an automatic CPU and NUMA configuration on the VM.
+    # 
+    # An example for a request:
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/autopincpuandnumanodes
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <optimize_cpu_settings>true</optimize_cpu_settings>
+    # </action>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the detach action should be performed asynchronously.
+    # 
+    # @option opts [Boolean] :optimize_cpu_settings Specifies how the auto CPU and NUMA configuration is applied.
+    #   If set to true, will adjust the CPU topology to fit the VM pinned host hardware.
+    #   Otherwise, it will use the VM CPU topology.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def auto_pin_cpu_and_numa_nodes(opts = {})
+      internal_action(:autopincpuandnumanodes, nil, AUTO_PIN_CPU_AND_NUMA_NODES, opts)
+    end
+    
     CANCEL_MIGRATION = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -29547,6 +30010,8 @@ module OvirtSDK4
     # </action>
     # ----
     # 
+    # NOTE: Confirm that the export operation has completed before attempting any actions on the export domain.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the export should be performed asynchronously.
@@ -29619,6 +30084,7 @@ module OvirtSDK4
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
       [:next_run, TrueClass].freeze,
+      [:ovf_as_ova, TrueClass].freeze,
     ].freeze
     
     private_constant :GET
@@ -29671,6 +30137,16 @@ module OvirtSDK4
     #   GET /vms/{vm:id};next_run=true
     #   ----
     # 
+    # @option opts [Boolean] :ovf_as_ova Indicates if the results should expose the OVF as it appears in OVA files of that VM. The OVF document
+    #   describing the virtual machine. This parameter will work only when all_content=True is set.
+    #   The OVF will be presented in `initialization.configuration.data`.
+    #   
+    #   For example:
+    #   [source]
+    #   ----
+    #   GET /vms/{vm:id}?all_content=true&ovf_as_ova=true
+    #   ----
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -29919,6 +30395,7 @@ module OvirtSDK4
     
     REBOOT = [
       [:async, TrueClass].freeze,
+      [:force, TrueClass].freeze,
     ].freeze
     
     private_constant :REBOOT
@@ -29941,10 +30418,29 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # To reboot the VM even if a backup is running for it,
+    # the action should include the 'force' element.
+    # 
+    # For example, to force reboot virtual machine `123`:
+    # 
+    # ----
+    # POST /ovirt-engine/api/vms/123/reboot
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <force>true</force>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the reboot should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the VM should be forcibly rebooted even
+    #   if a backup is running for it.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -30025,6 +30521,7 @@ module OvirtSDK4
     
     SHUTDOWN = [
       [:async, TrueClass].freeze,
+      [:force, TrueClass].freeze,
       [:reason, String].freeze,
     ].freeze
     
@@ -30048,10 +30545,29 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # To shutdown the VM even if a backup is running for it,
+    # the action should include the 'force' element.
+    # 
+    # For example, to force shutdown virtual machine `123`:
+    # 
+    # ----
+    # POST /ovirt-engine/api/vms/123/shutdown
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <force>true</force>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the shutdown should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the VM should be forcibly shutdown even
+    #   if a backup is running for it.
+    # 
     # @option opts [String] :reason The reason the virtual machine was stopped.
     #   Optionally set by user when shutting down the virtual machine.
     # 
@@ -30168,6 +30684,7 @@ module OvirtSDK4
     
     STOP = [
       [:async, TrueClass].freeze,
+      [:force, TrueClass].freeze,
       [:reason, String].freeze,
     ].freeze
     
@@ -30191,10 +30708,29 @@ module OvirtSDK4
     # <action/>
     # ----
     # 
+    # To stop the VM even if a backup is running for it,
+    # the action should include the 'force' element.
+    # 
+    # For example, to force stop virtual machine `123`:
+    # 
+    # ----
+    # POST /ovirt-engine/api/vms/123/stop
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #     <force>true</force>
+    # </action>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the stop action should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the VM should be forcibly stop even
+    #   if a backup is running for it.
+    # 
     # @option opts [String] :reason The reason the virtual machine was stopped.
     #   Optionally set by user when shutting down the virtual machine.
     # 
@@ -30548,6 +31084,15 @@ module OvirtSDK4
       @cdroms_service ||= VmCdromsService.new(self, 'cdroms')
     end
     
+    # 
+    # List of checkpoints of this virtual machine.
+    # 
+    # @return [VmCheckpointsService] A reference to `checkpoints` service.
+    # 
+    def checkpoints_service
+      @checkpoints_service ||= VmCheckpointsService.new(self, 'checkpoints')
+    end
+    
     # 
     # List of disks attached to this virtual machine.
     # 
@@ -30701,6 +31246,12 @@ module OvirtSDK4
       if path.start_with?('cdroms/')
         return cdroms_service.service(path[7..-1])
       end
+      if path == 'checkpoints'
+        return checkpoints_service
+      end
+      if path.start_with?('checkpoints/')
+        return checkpoints_service.service(path[12..-1])
+      end
       if path == 'diskattachments'
         return disk_attachments_service
       end
@@ -31106,6 +31657,7 @@ module OvirtSDK4
   class VmBackupsService < Service
     
     ADD = [
+      [:require_consistency, TrueClass].freeze,
     ].freeze
     
     private_constant :ADD
@@ -31125,7 +31677,6 @@ module OvirtSDK4
     # 
     # [source,xml]
     # ----
-    # POST /ovirt-engine/api/vms/123/backups
     # <backup>
     #   <from_checkpoint_id>previous-checkpoint-uuid</from_checkpoint_id>
     #   <disks>
@@ -31156,6 +31707,19 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :require_consistency Indicates if the backup will fail if VM failed to freeze or not.
+    #   
+    #   If requireConsistency=True VM backup will fail in case of a
+    #   failure to freeze the VM.
+    #   
+    #   The REST API call should look like this:
+    #   
+    #   ....
+    #   POST /ovirt-engine/api/vms/123/backups?require_consistency=true
+    #   ....
+    #   
+    #   The default value of the requireConsistency flag is `false`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -31483,6 +32047,273 @@ module OvirtSDK4
     
   end
   
+  class VmCheckpointService < Service
+    
+    GET = [
+      [:follow, String].freeze,
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Returns information about the virtual machine checkpoint.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [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 [Checkpoint]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    REMOVE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Remove the virtual machine checkpoint entity.
+    # 
+    # Remove the checkpoint from libvirt and the database.
+    # 
+    # @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
+    
+    # 
+    # A reference to the service that lists the disks in checkpoint.
+    # 
+    # @return [VmCheckpointDisksService] A reference to `disks` service.
+    # 
+    def disks_service
+      @disks_service ||= VmCheckpointDisksService.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 VmCheckpointDiskService < 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 VmCheckpointDisksService < Service
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # Returns the list of disks in checkpoint.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of disks to return. If not specified, all the disks are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<Disk>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # A reference to the service that manages a specific disk.
+    # 
+    # @param id [String] The identifier of the `disk`.
+    # 
+    # @return [VmCheckpointDiskService] A reference to the `disk` service.
+    # 
+    def disk_service(id)
+      VmCheckpointDiskService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return disk_service(path)
+      end
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
+  class VmCheckpointsService < Service
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # The list of virtual machine checkpoints.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [String] :follow Indicates which inner links should be _followed_. The objects referenced by these links will be fetched as part
+    #   of the current request. See <<documents/003_common_concepts/follow, here>> for details.
+    # 
+    # @option opts [Integer] :max Sets the maximum number of virtual machine checkpoints to return.
+    #   If not specified, all the virtual machine checkpoints are returned.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    # @return [Array<Checkpoint>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Returns a reference to the service that manages a specific VM checkpoint.
+    # 
+    # @param id [String] The identifier of the `checkpoint`.
+    # 
+    # @return [VmCheckpointService] A reference to the `checkpoint` service.
+    # 
+    def checkpoint_service(id)
+      VmCheckpointService.new(self, id)
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return checkpoint_service(path)
+      end
+      return checkpoint_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
   class VmDiskService < MeasurableService
     
     ACTIVATE = [
@@ -33027,6 +33858,7 @@ module OvirtSDK4
     #   </cpu>
     #   <index>0</index>
     #   <memory>1024</memory>
+    #   <numa_tune_mode>strict</numa_tune_mode>
     # </vm_numa_node>
     # ----
     # 
@@ -34516,6 +35348,7 @@ module OvirtSDK4
       [:filter, TrueClass].freeze,
       [:follow, String].freeze,
       [:max, Integer].freeze,
+      [:ovf_as_ova, TrueClass].freeze,
       [:search, String].freeze,
     ].freeze
     
@@ -34559,6 +35392,16 @@ module OvirtSDK4
     # 
     # @option opts [Integer] :max The maximum number of results to return.
     # 
+    # @option opts [Boolean] :ovf_as_ova Indicates if the results should expose the OVF as it appears in OVA files of that VM. The OVF document
+    #   describing the virtual machine. This parameter will work only when all_content=True is set.
+    #   The OVF will be presented in `initialization.configuration.data`.
+    #   
+    #   For example:
+    #   [source]
+    #   ----
+    #   GET /vms?all_content=true&ovf_as_ova=true
+    #   ----
+    # 
     # @option opts [String] :search A query string used to restrict the returned virtual machines.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -35785,6 +36628,26 @@ module OvirtSDK4
       internal_update(disk, Disk, UPDATE, opts)
     end
     
+    # 
+    # Reference to the service that manages the DiskSnapshots.
+    # 
+    # For example, to list all disk snapshots under the disks resource '123':
+    # 
+    # ....
+    # GET /ovirt-engine/api/disks/123/disksnapshots
+    # ....
+    # 
+    # For example, to retrieve a specific disk snapshot '789' under the disk resource '123':
+    # ....
+    # GET /ovirt-engine/api/disks/123/disksnapshots/789
+    # ....
+    # 
+    # @return [DiskSnapshotsService] A reference to `disk_snapshots` service.
+    # 
+    def disk_snapshots_service
+      @disk_snapshots_service ||= DiskSnapshotsService.new(self, 'disksnapshots')
+    end
+    
     # 
     # Reference to the service that manages the permissions assigned to the disk.
     # 
@@ -35814,6 +36677,12 @@ module OvirtSDK4
       if path.nil? || path == ''
         return self
       end
+      if path == 'disksnapshots'
+        return disk_snapshots_service
+      end
+      if path.start_with?('disksnapshots/')
+        return disk_snapshots_service.service(path[14..-1])
+      end
       if path == 'permissions'
         return permissions_service
       end
@@ -36928,6 +37797,7 @@ module OvirtSDK4
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
+      [:reboot, TrueClass].freeze,
     ].freeze
     
     private_constant :APPROVE
@@ -36949,6 +37819,8 @@ module OvirtSDK4
     # 
     # @option opts [Host] :host The host to approve.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -37025,6 +37897,9 @@ module OvirtSDK4
     # 
     # Copy the network configuration of the specified host to current host.
     # 
+    # IMPORTANT: Any network attachments that are not present on the source host will be erased from the target host
+    # by the copy operation.
+    # 
     # To copy networks from another host, send a request like this:
     # 
     # [source]
@@ -37037,7 +37912,7 @@ module OvirtSDK4
     # [source,xml]
     # ----
     # <action>
-    #    <sourceHost id="456" />
+    #    <source_host id="456"/>
     # </action>
     # ----
     # 
@@ -37093,6 +37968,71 @@ module OvirtSDK4
       internal_action(:deactivate, nil, DEACTIVATE, opts)
     end
     
+    DISCOVER_ISCSI = [
+      [:async, TrueClass].freeze,
+      [:iscsi, IscsiDetails].freeze,
+    ].freeze
+    
+    private_constant :DISCOVER_ISCSI
+    
+    # 
+    # Discovers iSCSI targets on the host, using the initiator details.
+    # Returns a list of IscsiDetails objects containing the discovered data.
+    # 
+    # For example, to discover iSCSI targets available in `myiscsi.example.com`,
+    # from host `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts/123/discoveriscsi
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <iscsi>
+    #     <address>myiscsi.example.com</address>
+    #   </iscsi>
+    # </action>
+    # ----
+    # 
+    # The result will be like this:
+    # 
+    # [source,xml]
+    # ----
+    # <discovered_targets>
+    #   <iscsi_details>
+    #     <address>10.35.1.72</address>
+    #     <port>3260</port>
+    #     <portal>10.35.1.72:3260,1</portal>
+    #     <target>iqn.2015-08.com.tgt:444</target>
+    #   </iscsi_details>
+    # </discovered_targets>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the discovery should be performed asynchronously.
+    # 
+    # @option opts [Array<IscsiDetails>] :discovered_targets The discovered targets including all connection information.
+    # 
+    # @option opts [IscsiDetails] :iscsi The target iSCSI device.
+    # 
+    # @option opts [Hash] :headers ({}) Additional HTTP headers.
+    # 
+    # @option opts [Hash] :query ({}) Additional URL query parameters.
+    # 
+    # @option opts [Integer] :timeout (nil) The timeout for this request, in seconds. If no value is explicitly 
+    #   given then the timeout set globally for the connection will be used.
+    # 
+    # @option opts [Boolean] :wait (true) If `true` wait for the response.
+    # 
+    def discover_iscsi(opts = {})
+      internal_action(:discoveriscsi, :discovered_targets, DISCOVER_ISCSI, opts)
+    end
+    
     ENROLL_CERTIFICATE = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -37278,6 +38218,7 @@ module OvirtSDK4
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
       [:image, String].freeze,
+      [:reboot, TrueClass].freeze,
       [:root_password, String].freeze,
       [:ssh, Ssh].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
@@ -37329,9 +38270,10 @@ module OvirtSDK4
     # --data '
     # {
     #   "root_password": "myrootpassword"
+    # "deploy_hosted_engine" : "true"
     # }
     # ' \
-    # "https://engine.example.com/ovirt-engine/api/hosts/123?deploy_hosted_engine=true"
+    # "https://engine.example.com/ovirt-engine/api/hosts/123"
     # ----
     # 
     # IMPORTANT: Since version 4.1.2 of the engine, when a host is reinstalled we override the host firewall
@@ -37354,6 +38296,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [String] :root_password The password of the `root` user used to connect to the host via SSH.
     # 
     # @option opts [Ssh] :ssh The SSH details used to connect to the host.
@@ -37382,8 +38326,12 @@ module OvirtSDK4
     
     private_constant :ISCSI_DISCOVER
     
+    # 
+    # This method has been deprecated since Engine version 4.4.6.
+    # DiscoverIscsi should be used instead.
     # 
     # Discovers iSCSI targets on the host, using the initiator details.
+    # Returns an array of strings containing the discovered data.
     # 
     # For example, to discover iSCSI targets available in `myiscsi.example.com`,
     # from host `123`, send a request like this:
@@ -37404,32 +38352,14 @@ module OvirtSDK4
     # </action>
     # ----
     # 
-    # The result will be like this:
-    # 
-    # [source,xml]
-    # ----
-    # <discovered_targets>
-    #   <iscsi_details>
-    #     <address>10.35.1.72</address>
-    #     <port>3260</port>
-    #     <portal>10.35.1.72:3260,1</portal>
-    #     <target>iqn.2015-08.com.tgt:444</target>
-    #   </iscsi_details>
-    # </discovered_targets>
-    # ----
-    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the discovery should be performed asynchronously.
     # 
-    # @option opts [Array<IscsiDetails>] :discovered_targets The discovered targets including all connection information.
-    # 
     # @option opts [IscsiDetails] :iscsi The target iSCSI device.
     # 
     # @option opts [Array<String>] :iscsi_targets The iSCSI targets.
-    #   
-    #   Since version 4.2 of the engine, this parameter is deprecated, use
-    #   `discovered_targets` instead.
+    #           *
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -37619,8 +38549,8 @@ module OvirtSDK4
     #         <name>bond0</name>
     #       </host_nic>
     #       <ip_address_assignments>
-    #         <assignment_method>static</assignment_method>
     #         <ip_address_assignment>
+    #           <assignment_method>static</assignment_method>
     #           <ip>
     #             <address>192.168.122.10</address>
     #             <netmask>255.255.255.0</netmask>
@@ -37963,6 +38893,7 @@ module OvirtSDK4
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
+      [:reboot, TrueClass].freeze,
     ].freeze
     
     private_constant :APPROVE_USING_ROOT_PASSWORD
@@ -37982,6 +38913,8 @@ module OvirtSDK4
     # 
     # @option opts [Host] :host The host to approve.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -38001,6 +38934,7 @@ module OvirtSDK4
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
       [:image, String].freeze,
+      [:reboot, TrueClass].freeze,
       [:root_password, String].freeze,
       [:ssh, Ssh].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
@@ -38029,6 +38963,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [String] :root_password The password of the `root` user used to connect to the host via SSH.
     # 
     # @option opts [Ssh] :ssh The SSH details used to connect to the host.
@@ -38084,6 +39020,7 @@ module OvirtSDK4
       [:async, TrueClass].freeze,
       [:cluster, Cluster].freeze,
       [:host, Host].freeze,
+      [:reboot, TrueClass].freeze,
     ].freeze
     
     private_constant :APPROVE_USING_SSH
@@ -38104,6 +39041,8 @@ module OvirtSDK4
     # 
     # @option opts [Host] :host The host to approve.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -38123,6 +39062,7 @@ module OvirtSDK4
       [:deploy_hosted_engine, TrueClass].freeze,
       [:host, Host].freeze,
       [:image, String].freeze,
+      [:reboot, TrueClass].freeze,
       [:root_password, String].freeze,
       [:ssh, Ssh].freeze,
       [:undeploy_hosted_engine, TrueClass].freeze,
@@ -38151,6 +39091,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after successful installation. The default value is `true`.
+    # 
     # @option opts [String] :root_password The password of the `root` user used to connect to the host via SSH.
     # 
     # @option opts [Ssh] :ssh The SSH details used to connect to the host.