ovirt-engine-sdk 4.3.1 → 4.4.0

data/lib/ovirtsdk4/service.rb

@@ -43,6 +43,7 @@ module OvirtSDK4
     def wait
       response = @service.connection.wait(@request)
       raise response if response.is_a?(Exception)
+
       @block.call(response)
     end
 
@@ -116,6 +117,7 @@ module OvirtSDK4
       connection.raise_error(response, body) if body.is_a?(Fault)
       if body.is_a?(Action)
         return body if body.fault.nil?
+
         connection.raise_error(response, body.fault)
       end
       raise Error, "Expected an action or a fault, but got '#{body.class.name.split('::').last}'"
@@ -133,6 +135,7 @@ module OvirtSDK4
     #
     def connection
       return @parent if @parent.is_a? Connection
+
       @parent.connection
     end
 
@@ -191,6 +194,7 @@ module OvirtSDK4
       connection.send(request)
       result = Future.new(self, request) do |response|
         raise response if response.is_a?(Exception)
+
         case response.code
         when 200
           internal_read_body(response)
@@ -241,6 +245,7 @@ module OvirtSDK4
       connection.send(request)
       result = Future.new(self, request) do |response|
         raise response if response.is_a?(Exception)
+
         case response.code
         when 200, 201, 202
           internal_read_body(response)
@@ -291,6 +296,7 @@ module OvirtSDK4
       connection.send(request)
       result = Future.new(self, request) do |response|
         raise response if response.is_a?(Exception)
+
         case response.code
         when 200
           internal_read_body(response)
@@ -337,6 +343,7 @@ module OvirtSDK4
       connection.send(request)
       result = Future.new(self, request) do |response|
         raise response if response.is_a?(Exception)
+
         check_fault(response) unless response.code == 200
       end
       result = result.wait if wait
@@ -383,6 +390,7 @@ module OvirtSDK4
       connection.send(request)
       result = Future.new(self, request) do |response|
         raise response if response.is_a?(Exception)
+
         case response.code
         when 200, 201, 202
           action = check_action(response)
@@ -428,8 +436,10 @@ module OvirtSDK4
     #
     def absolute_path
       return @path if @parent.is_a? Connection
+
       prefix = @parent.absolute_path
       return @path if prefix.empty?
+
       "#{prefix}/#{@path}"
     end
 
@@ -444,6 +454,7 @@ module OvirtSDK4
     #
     def check_bad_opts(specs, opts)
       return if opts.empty?
+
       bad_names = opts.keys
       bad_text = nice_list(bad_names)
       if bad_names.length > 1
@@ -472,9 +483,11 @@ module OvirtSDK4
     #
     def nice_list(items)
       return nil if items.empty?
+
       items = items.sort
       items = items.map { |item| "'#{item}'" }
       return items.first if items.length == 1
+
       head = items[0, items.length - 1].join(', ')
       tail = items.last
       "#{head} and #{tail}"

data/lib/ovirtsdk4/services.rb

@@ -23,12 +23,18 @@ module OvirtSDK4
   class AffinityGroupService < Service
   end
   
+  class AffinityGroupHostService < Service
+  end
+  
   class AffinityGroupHostLabelService < Service
   end
   
   class AffinityGroupHostLabelsService < Service
   end
   
+  class AffinityGroupHostsService < Service
+  end
+  
   class AffinityGroupVmService < Service
   end
   
@@ -221,6 +227,12 @@ module OvirtSDK4
   class EventService < Service
   end
   
+  class EventSubscriptionService < Service
+  end
+  
+  class EventSubscriptionsService < Service
+  end
+  
   class EventsService < Service
   end
   
@@ -953,6 +965,17 @@ module OvirtSDK4
       @host_labels_service ||= AffinityGroupHostLabelsService.new(self, 'hostlabels')
     end
     
+    # 
+    # Returns a reference to the service that manages the
+    # list of all hosts attached to this affinity
+    # group.
+    # 
+    # @return [AffinityGroupHostsService] A reference to `hosts` service.
+    # 
+    def hosts_service
+      @hosts_service ||= AffinityGroupHostsService.new(self, 'hosts')
+    end
+    
     # 
     # Returns a reference to the service that manages the
     # list of all virtual machine labels attached to this affinity
@@ -992,6 +1015,12 @@ module OvirtSDK4
       if path.start_with?('hostlabels/')
         return host_labels_service.service(path[11..-1])
       end
+      if path == 'hosts'
+        return hosts_service
+      end
+      if path.start_with?('hosts/')
+        return hosts_service.service(path[6..-1])
+      end
       if path == 'vmlabels'
         return vm_labels_service
       end
@@ -1009,6 +1038,49 @@ module OvirtSDK4
     
   end
   
+  class AffinityGroupHostService < Service
+    
+    REMOVE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Remove host from the affinity group.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the removal 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
+    
+    # 
+    # 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 AffinityGroupHostLabelService < Service
     
     REMOVE = [
@@ -1156,7 +1228,116 @@ module OvirtSDK4
       if index.nil?
         return label_service(path)
       end
-      return label_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return label_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
+  class AffinityGroupHostsService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Adds a host to the affinity group.
+    # 
+    # For example, to add the host `789` to the affinity group `456` of cluster `123`, send a request like
+    # this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/clusters/123/affinitygroups/456/hosts
+    # ....
+    # 
+    # With the following body:
+    # 
+    # [source,xml]
+    # ----
+    # <host id="789"/>
+    # ----
+    # 
+    # @param host [Host] The host to be added to the affinity group.
+    # 
+    # @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 [Host]
+    # 
+    def add(host, opts = {})
+      internal_add(host, Host, ADD, opts)
+    end
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # List all hosts assigned to this affinity group.
+    # 
+    # The order of the returned hosts 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 hosts to return. If not specified, all the hosts 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<Host>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Access the service that manages the host assignment to this affinity group.
+    # 
+    # @param id [String] The identifier of the `host`.
+    # 
+    # @return [AffinityGroupHostService] A reference to the `host` service.
+    # 
+    def host_service(id)
+      AffinityGroupHostService.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 host_service(path)
+      end
+      return host_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -1351,7 +1532,7 @@ module OvirtSDK4
       if index.nil?
         return label_service(path)
       end
-      return label_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return label_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -1460,7 +1641,7 @@ module OvirtSDK4
       if index.nil?
         return vm_service(path)
       end
-      return vm_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return vm_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -1577,7 +1758,7 @@ module OvirtSDK4
       if index.nil?
         return group_service(path)
       end
-      return group_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return group_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -1867,7 +2048,7 @@ module OvirtSDK4
       if index.nil?
         return host_service(path)
       end
-      return host_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return host_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -2029,7 +2210,7 @@ module OvirtSDK4
       if index.nil?
         return vm_service(path)
       end
-      return vm_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return vm_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -2124,7 +2305,7 @@ module OvirtSDK4
       if index.nil?
         return label_service(path)
       end
-      return label_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return label_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -2304,7 +2485,7 @@ module OvirtSDK4
       if index.nil?
         return label_service(path)
       end
-      return label_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return label_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -2470,7 +2651,7 @@ module OvirtSDK4
       if index.nil?
         return profile_service(path)
       end
-      return profile_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return profile_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -2636,7 +2817,7 @@ module OvirtSDK4
       if index.nil?
         return profile_service(path)
       end
-      return profile_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return profile_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -3050,7 +3231,7 @@ module OvirtSDK4
       if index.nil?
         return permission_service(path)
       end
-      return permission_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return permission_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -3117,7 +3298,7 @@ module OvirtSDK4
       if index.nil?
         return role_service(path)
       end
-      return role_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return role_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -3337,7 +3518,7 @@ module OvirtSDK4
       if index.nil?
         return tag_service(path)
       end
-      return tag_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return tag_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -3518,7 +3699,7 @@ module OvirtSDK4
       if index.nil?
         return profile_service(path)
       end
-      return profile_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return profile_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -3845,7 +4026,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -3939,7 +4120,7 @@ module OvirtSDK4
       if index.nil?
         return storage_domain_service(path)
       end
-      return storage_domain_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return storage_domain_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -4111,7 +4292,7 @@ module OvirtSDK4
       if index.nil?
         return balance_service(path)
       end
-      return balance_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return balance_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -4381,7 +4562,7 @@ module OvirtSDK4
       if index.nil?
         return bookmark_service(path)
       end
-      return bookmark_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return bookmark_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -4496,6 +4677,37 @@ module OvirtSDK4
       internal_get(GET, opts)
     end
     
+    REFRESH_GLUSTER_HEAL_STATUS = [
+    ].freeze
+    
+    private_constant :REFRESH_GLUSTER_HEAL_STATUS
+    
+    # 
+    # Refresh the Gluster heal info for all volumes in cluster.
+    # 
+    # For example, Cluster `123`, send a request like
+    # this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/123/refreshglusterhealstatus
+    # ----
+    # 
+    # @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 refresh_gluster_heal_status(opts = {})
+      internal_action(:refreshglusterhealstatus, nil, REFRESH_GLUSTER_HEAL_STATUS, opts)
+    end
+    
     REMOVE = [
       [:async, TrueClass].freeze,
     ].freeze
@@ -5047,7 +5259,7 @@ module OvirtSDK4
       if index.nil?
         return feature_service(path)
       end
-      return feature_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return feature_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -5238,7 +5450,7 @@ module OvirtSDK4
       if index.nil?
         return feature_service(path)
       end
-      return feature_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return feature_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -5412,7 +5624,7 @@ module OvirtSDK4
       if index.nil?
         return level_service(path)
       end
-      return level_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return level_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -5616,7 +5828,7 @@ module OvirtSDK4
       if index.nil?
         return network_service(path)
       end
-      return network_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return network_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -5767,7 +5979,7 @@ module OvirtSDK4
       if index.nil?
         return cluster_service(path)
       end
-      return cluster_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return cluster_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -6021,7 +6233,7 @@ module OvirtSDK4
       if index.nil?
         return profile_service(path)
       end
-      return profile_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return profile_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -6532,7 +6744,7 @@ module OvirtSDK4
       if index.nil?
         return network_service(path)
       end
-      return network_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return network_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -6712,7 +6924,7 @@ module OvirtSDK4
       if index.nil?
         return data_center_service(path)
       end
-      return data_center_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return data_center_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -7042,7 +7254,7 @@ module OvirtSDK4
       if index.nil?
         return attachment_service(path)
       end
-      return attachment_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return attachment_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -7252,7 +7464,7 @@ module OvirtSDK4
       if index.nil?
         return disk_profile_service(path)
       end
-      return disk_profile_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_profile_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -7391,7 +7603,7 @@ module OvirtSDK4
       if index.nil?
         return snapshot_service(path)
       end
-      return snapshot_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return snapshot_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -7731,7 +7943,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -7949,7 +8161,7 @@ module OvirtSDK4
       if index.nil?
         return group_service(path)
       end
-      return group_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return group_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -8164,7 +8376,7 @@ module OvirtSDK4
       if index.nil?
         return user_service(path)
       end
-      return user_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return user_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -8252,7 +8464,7 @@ module OvirtSDK4
       if index.nil?
         return domain_service(path)
       end
-      return domain_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return domain_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -8364,6 +8576,240 @@ module OvirtSDK4
     
   end
   
+  class EventSubscriptionService < Service
+    
+    GET = [
+    ].freeze
+    
+    private_constant :GET
+    
+    # 
+    # Gets the information about the event-subscription.
+    # 
+    # For example to retrieve the information about the subscription of user '123' to
+    # the event 'vm_console_detected':
+    # 
+    # ....
+    # GET /ovirt-engine/api/users/123/vm_console_detected
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <event-subscription href="/ovirt-engine/api/users/123/event-subscriptions/vm_console_detected">
+    #   <event>vm_console_detected</event>
+    #   <notification_method>smtp</notification_method>
+    #   <user href="/ovirt-engine/api/users/123" id="123"/>
+    #   <address>a@b.com</address>
+    # </event-subscription>
+    # ----
+    # 
+    # @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 [EventSubscription]
+    # 
+    def get(opts = {})
+      internal_get(GET, opts)
+    end
+    
+    REMOVE = [
+      [:async, TrueClass].freeze,
+    ].freeze
+    
+    private_constant :REMOVE
+    
+    # 
+    # Removes the event-subscription from the system.
+    # 
+    # For example to remove user 123's subscription to `vm_console_detected` event:
+    # 
+    # ....
+    # DELETE /ovirt-engine/api/users/123/vm_console_detected
+    # ....
+    # 
+    # @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
+    
+    # 
+    # 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 EventSubscriptionsService < Service
+    
+    ADD = [
+    ].freeze
+    
+    private_constant :ADD
+    
+    # 
+    # Add a new event-subscription to the system.
+    # 
+    # An event-subscription is always added in the context of a user. For example, to add new
+    # event-subscription for `host_high_cpu_use` for user `123`, and have the notification
+    # sent to the e-mail address: `a@b.com`, send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/users/123/eventsubscriptions
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <event_subscription>
+    #     <event>host_high_cpu_use</event>
+    #     <address>a@b.com</address>
+    # </event_subscription>
+    # ----
+    # 
+    # The event name will become the ID of the new event-subscription entity:
+    # GET .../api/users/123/eventsubscriptions/host_high_cpu_use
+    # 
+    # Note that no user id is provided in the request body. This is because the user-id (in this case 123)
+    # is already known to the API from the context. Note also that event-subscription entity contains
+    # notification-method field, but it is not provided either in the request body. This is because currently
+    # it's always set to SMTP as SNMP notifications are still unsupported by the API layer.
+    # 
+    # @param event_subscription [EventSubscription] The added event-subscription.
+    # 
+    # @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 [EventSubscription]
+    # 
+    def add(event_subscription, opts = {})
+      internal_add(event_subscription, EventSubscription, ADD, opts)
+    end
+    
+    LIST = [
+      [:follow, String].freeze,
+      [:max, Integer].freeze,
+    ].freeze
+    
+    private_constant :LIST
+    
+    # 
+    # List the event-subscriptions for the provided user.
+    # 
+    # For example to list event-subscriptions for user `123`:
+    # 
+    # ....
+    # GET /ovirt-engine/api/users/123/event-subscriptions
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <event-subscriptions>
+    #   <event-subscription href="/ovirt-engine/api/users/123/event-subscriptions/host_install_failed">
+    #     <event>host_install_failed</event>
+    #     <notification_method>smtp</notification_method>
+    #     <user href="/ovirt-engine/api/users/123" id="123"/>
+    #     <address>a@b.com</address>
+    #   </event-subscription>
+    #   <event-subscription href="/ovirt-engine/api/users/123/event-subscriptions/vm_paused">
+    #     <event>vm_paused</event>
+    #     <notification_method>smtp</notification_method>
+    #     <user href="/ovirt-engine/api/users/123" id="123"/>
+    #     <address>a@b.com</address>
+    #   </event-subscription>
+    # </event-subscriptions>
+    # ----
+    # 
+    # @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 event-subscriptions to return.
+    #   If not specified all the event-subscriptions 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<EventSubscription>]
+    # 
+    def list(opts = {})
+      internal_get(LIST, opts)
+    end
+    
+    # 
+    # Reference to the service that manages a specific event-subscription.
+    # 
+    # @param id [String] The identifier of the `event_subscription`.
+    # 
+    # @return [EventSubscriptionService] A reference to the `event_subscription` service.
+    # 
+    def event_subscription_service(id)
+      EventSubscriptionService.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 event_subscription_service(path)
+      end
+      return event_subscription_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
+    end
+    
+  end
+  
   class EventsService < Service
     
     ADD = [
@@ -8643,7 +9089,7 @@ module OvirtSDK4
       if index.nil?
         return event_service(path)
       end
-      return event_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return event_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -8798,7 +9244,7 @@ module OvirtSDK4
       if index.nil?
         return resource_service(path)
       end
-      return resource_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return resource_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -8967,7 +9413,7 @@ module OvirtSDK4
       if index.nil?
         return host_service(path)
       end
-      return host_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return host_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -9174,7 +9620,7 @@ module OvirtSDK4
       if index.nil?
         return group_service(path)
       end
-      return group_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return group_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -9271,7 +9717,7 @@ module OvirtSDK4
       if index.nil?
         return provider_service(path)
       end
-      return provider_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return provider_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -9338,7 +9784,7 @@ module OvirtSDK4
       if index.nil?
         return host_service(path)
       end
-      return host_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return host_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -9449,7 +9895,7 @@ module OvirtSDK4
       if index.nil?
         return configuration_service(path)
       end
-      return configuration_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return configuration_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -9687,7 +10133,7 @@ module OvirtSDK4
       if index.nil?
         return certificate_service(path)
       end
-      return certificate_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return certificate_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -9900,6 +10346,73 @@ module OvirtSDK4
     # 
     # Add a new fencing-agent to the host.
     # 
+    # [source]
+    # 
+    # ----
+    # POST /ovirt-engine/api/hosts/123/fenceagents
+    # 
+    # You should consult the /usr/sbin/fence_<agent_name> manual page for
+    # the legal parameters to [name1=value1, name2=value2,...] in the options field.
+    # If any parameter in options appears by name that means that it is mandatory.
+    # For example in <options>slot=7[,name1=value1, name2=value2,...]</options>
+    # slot is mandatory.
+    # ----
+    # 
+    # apc, bladecenter, wti fencing agent/s sample request:
+    # 
+    # [source,xml]
+    # 
+    #   <agent>
+    #     <type>apc</type>
+    #     <order>1</order>
+    #     <ip>192.168.1.101</ip>
+    #     <user>user</user>
+    #     <password>xxx</password>
+    #     <port>9</port>
+    #     <options>slot=7[,name1=value1, name2=value2,...]</options>
+    #   </agent>
+    # 
+    # apc_snmp, hpblade, ilo, ilo2, ilo_ssh, redfish, rsa fencing agent/s sample request:
+    # 
+    # [source,xml]
+    # 
+    #   <agent>
+    #     <type>apc_snmp</type>
+    #     <order>1</order>
+    #     <ip>192.168.1.101</ip>
+    #     <user>user</user>
+    #     <password>xxx</password>
+    #     <port>9</port>
+    #     <options>[name1=value1, name2=value2,...]</options>
+    #   </agent>
+    # 
+    # 
+    # cisco_ucs, drac5, eps fencing agent/s sample request:
+    # 
+    # [source,xml]
+    # 
+    #   <agent>
+    #     <type>cisco_ucs</type>
+    #     <order>1</order>
+    #     <ip>192.168.1.101</ip>
+    #     <user>user</user>
+    #     <password>xxx</password>
+    #     <options>slot=7[,name1=value1, name2=value2,...]</options>
+    #   </agent>
+    # 
+    # drac7, ilo3, ilo4, ipmilan, rsb fencing agent/s sample request:
+    # 
+    # [source,xml]
+    # 
+    #   <agent>
+    #     <type>drac7</type>
+    #     <order>1</order>
+    #     <ip>192.168.1.101</ip>
+    #     <user>user</user>
+    #     <password>xxx</password>
+    #     <options>[name1=value1, name2=value2,...]</options>
+    #   </agent>
+    # 
     # @param agent [Agent] The `agent` to add.
     # 
     # @param opts [Hash] Additional options.
@@ -10002,7 +10515,7 @@ module OvirtSDK4
       if index.nil?
         return agent_service(path)
       end
-      return agent_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return agent_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -10142,7 +10655,7 @@ module OvirtSDK4
       if index.nil?
         return file_service(path)
       end
-      return file_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return file_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -10314,7 +10827,7 @@ module OvirtSDK4
       if index.nil?
         return filter_service(path)
       end
-      return filter_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return filter_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -10695,7 +11208,7 @@ module OvirtSDK4
       if index.nil?
         return brick_service(path)
       end
-      return brick_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return brick_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -10928,7 +11441,7 @@ module OvirtSDK4
       if index.nil?
         return hook_service(path)
       end
-      return hook_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return hook_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11074,7 +11587,7 @@ module OvirtSDK4
       if index.nil?
         return volume_service(path)
       end
-      return volume_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return volume_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11368,7 +11881,7 @@ module OvirtSDK4
       if index.nil?
         return group_service(path)
       end
-      return group_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return group_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11501,7 +12014,7 @@ module OvirtSDK4
       if index.nil?
         return device_service(path)
       end
-      return device_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return device_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11615,7 +12128,7 @@ module OvirtSDK4
       if index.nil?
         return hook_service(path)
       end
-      return hook_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return hook_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11699,7 +12212,7 @@ module OvirtSDK4
       if index.nil?
         return nic_service(path)
       end
-      return nic_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return nic_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11766,7 +12279,7 @@ module OvirtSDK4
       if index.nil?
         return node_service(path)
       end
-      return node_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return node_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -11898,7 +12411,7 @@ module OvirtSDK4
       if index.nil?
         return storage_service(path)
       end
-      return storage_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return storage_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -12232,7 +12745,7 @@ module OvirtSDK4
       if index.nil?
         return host_service(path)
       end
-      return host_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return host_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -12379,7 +12892,7 @@ module OvirtSDK4
       if index.nil?
         return icon_service(path)
       end
-      return icon_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return icon_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -12881,7 +13394,7 @@ module OvirtSDK4
       if index.nil?
         return image_transfer_service(path)
       end
-      return image_transfer_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return image_transfer_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -12948,7 +13461,7 @@ module OvirtSDK4
       if index.nil?
         return image_service(path)
       end
-      return image_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return image_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -13302,7 +13815,7 @@ module OvirtSDK4
       if index.nil?
         return console_service(path)
       end
-      return console_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return console_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -13500,7 +14013,7 @@ module OvirtSDK4
       if index.nil?
         return nic_service(path)
       end
-      return nic_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return nic_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -13699,7 +14212,7 @@ module OvirtSDK4
       if index.nil?
         return watchdog_service(path)
       end
-      return watchdog_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return watchdog_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -13886,7 +14399,7 @@ module OvirtSDK4
       if index.nil?
         return instance_type_service(path)
       end
-      return instance_type_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return instance_type_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -14160,7 +14673,7 @@ module OvirtSDK4
       if index.nil?
         return iscsi_bond_service(path)
       end
-      return iscsi_bond_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return iscsi_bond_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -14509,7 +15022,7 @@ module OvirtSDK4
       if index.nil?
         return job_service(path)
       end
-      return job_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return job_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -14606,7 +15119,7 @@ module OvirtSDK4
       if index.nil?
         return katello_erratum_service(path)
       end
-      return katello_erratum_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return katello_erratum_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -14985,7 +15498,7 @@ module OvirtSDK4
       if index.nil?
         return mac_pool_service(path)
       end
-      return mac_pool_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return mac_pool_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -15493,7 +16006,7 @@ module OvirtSDK4
       if index.nil?
         return attachment_service(path)
       end
-      return attachment_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return attachment_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -15604,7 +16117,7 @@ module OvirtSDK4
       if index.nil?
         return network_filter_service(path)
       end
-      return network_filter_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return network_filter_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -15794,7 +16307,7 @@ module OvirtSDK4
       if index.nil?
         return label_service(path)
       end
-      return label_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return label_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -15979,7 +16492,7 @@ module OvirtSDK4
       if index.nil?
         return network_service(path)
       end
-      return network_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return network_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -16210,7 +16723,7 @@ module OvirtSDK4
       if index.nil?
         return parameter_service(path)
       end
-      return parameter_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return parameter_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -16607,7 +17120,7 @@ module OvirtSDK4
       if index.nil?
         return provider_service(path)
       end
-      return provider_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return provider_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -16674,7 +17187,7 @@ module OvirtSDK4
       if index.nil?
         return image_service(path)
       end
-      return image_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return image_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -17096,7 +17609,7 @@ module OvirtSDK4
       if index.nil?
         return provider_service(path)
       end
-      return provider_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return provider_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -17163,7 +17676,7 @@ module OvirtSDK4
       if index.nil?
         return network_service(path)
       end
-      return network_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return network_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -17329,7 +17842,7 @@ module OvirtSDK4
       if index.nil?
         return subnet_service(path)
       end
-      return subnet_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return subnet_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -17521,7 +18034,7 @@ module OvirtSDK4
       if index.nil?
         return key_service(path)
       end
-      return key_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return key_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -17851,7 +18364,7 @@ module OvirtSDK4
       if index.nil?
         return provider_service(path)
       end
-      return provider_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return provider_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -17965,7 +18478,7 @@ module OvirtSDK4
       if index.nil?
         return type_service(path)
       end
-      return type_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return type_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -18079,7 +18592,7 @@ module OvirtSDK4
       if index.nil?
         return operating_system_service(path)
       end
-      return operating_system_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return operating_system_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -18376,7 +18889,7 @@ module OvirtSDK4
       if index.nil?
         return permit_service(path)
       end
-      return permit_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return permit_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -18657,7 +19170,7 @@ module OvirtSDK4
       if index.nil?
         return qos_service(path)
       end
-      return qos_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return qos_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -19015,7 +19528,7 @@ module OvirtSDK4
       if index.nil?
         return limit_service(path)
       end
-      return limit_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return limit_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -19214,7 +19727,7 @@ module OvirtSDK4
       if index.nil?
         return limit_service(path)
       end
-      return limit_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return limit_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -19323,7 +19836,7 @@ module OvirtSDK4
       if index.nil?
         return quota_service(path)
       end
-      return quota_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return quota_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -19622,7 +20135,7 @@ module OvirtSDK4
       if index.nil?
         return role_service(path)
       end
-      return role_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return role_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -19719,7 +20232,7 @@ module OvirtSDK4
       if index.nil?
         return policy_service(path)
       end
-      return policy_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return policy_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -20013,7 +20526,7 @@ module OvirtSDK4
       if index.nil?
         return unit_service(path)
       end
-      return unit_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return unit_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -20325,7 +20838,7 @@ module OvirtSDK4
       if index.nil?
         return cdrom_service(path)
       end
-      return cdrom_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return cdrom_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -20439,7 +20952,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -20553,7 +21066,7 @@ module OvirtSDK4
       if index.nil?
         return nic_service(path)
       end
-      return nic_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return nic_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -20717,7 +21230,7 @@ module OvirtSDK4
       if index.nil?
         return snapshot_service(path)
       end
-      return snapshot_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return snapshot_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -20951,7 +21464,7 @@ module OvirtSDK4
       if index.nil?
         return key_service(path)
       end
-      return key_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return key_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -21121,7 +21634,7 @@ module OvirtSDK4
       if index.nil?
         return statistic_service(path)
       end
-      return statistic_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return statistic_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -21419,7 +21932,7 @@ module OvirtSDK4
       if index.nil?
         return step_service(path)
       end
-      return step_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return step_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -22127,7 +22640,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -22569,7 +23082,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -22735,7 +23248,7 @@ module OvirtSDK4
       if index.nil?
         return connection_service(path)
       end
-      return connection_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return connection_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -23034,7 +23547,7 @@ module OvirtSDK4
       if index.nil?
         return template_service(path)
       end
-      return template_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return template_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -23438,7 +23951,7 @@ module OvirtSDK4
       if index.nil?
         return attachment_service(path)
       end
-      return attachment_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return attachment_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -23519,7 +24032,7 @@ module OvirtSDK4
       if index.nil?
         return vm_service(path)
       end
-      return vm_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return vm_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -23830,7 +24343,7 @@ module OvirtSDK4
       if index.nil?
         return storage_domain_service(path)
       end
-      return storage_domain_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return storage_domain_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -24392,7 +24905,7 @@ module OvirtSDK4
       if index.nil?
         return storage_connection_extension_service(path)
       end
-      return storage_connection_extension_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return storage_connection_extension_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -24643,7 +25156,7 @@ module OvirtSDK4
       if index.nil?
         return storage_connection_service(path)
       end
-      return storage_connection_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return storage_connection_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -25531,7 +26044,7 @@ module OvirtSDK4
       if index.nil?
         return option_service(path)
       end
-      return option_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return option_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -25945,7 +26458,7 @@ module OvirtSDK4
       if index.nil?
         return permission_service(path)
       end
-      return permission_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return permission_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -26250,7 +26763,7 @@ module OvirtSDK4
       if index.nil?
         return tag_service(path)
       end
-      return tag_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return tag_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -26742,7 +27255,7 @@ module OvirtSDK4
       if index.nil?
         return cdrom_service(path)
       end
-      return cdrom_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return cdrom_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -27025,7 +27538,7 @@ module OvirtSDK4
       if index.nil?
         return attachment_service(path)
       end
-      return attachment_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return attachment_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -27092,7 +27605,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -27258,7 +27771,7 @@ module OvirtSDK4
       if index.nil?
         return console_service(path)
       end
-      return console_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return console_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -27453,7 +27966,7 @@ module OvirtSDK4
       if index.nil?
         return nic_service(path)
       end
-      return nic_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return nic_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -27648,7 +28161,7 @@ module OvirtSDK4
       if index.nil?
         return watchdog_service(path)
       end
-      return watchdog_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return watchdog_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -28112,7 +28625,7 @@ module OvirtSDK4
       if index.nil?
         return template_service(path)
       end
-      return template_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return template_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -28251,7 +28764,7 @@ module OvirtSDK4
       if index.nil?
         return unmanaged_network_service(path)
       end
-      return unmanaged_network_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return unmanaged_network_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -28347,6 +28860,64 @@ module OvirtSDK4
       internal_remove(REMOVE, opts)
     end
     
+    UPDATE = [
+    ].freeze
+    
+    private_constant :UPDATE
+    
+    # 
+    # Updates information about the user.
+    # 
+    # Only the `user_options` field can be updated.
+    # 
+    # For example, to update user options:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/users/123
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <user>
+    #    <user_options>
+    #       <property>
+    #          <name>test</name>
+    #          <value>test1</value>
+    #       </property>
+    #    </user_options>
+    # </user>
+    # ----
+    # 
+    # @param user [User] The `user` 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 [User]
+    # 
+    def update(user, opts = {})
+      internal_update(user, User, UPDATE, opts)
+    end
+    
+    # 
+    # List of event-subscriptions for this user.
+    # 
+    # @return [EventSubscriptionsService] A reference to `event_subscriptions` service.
+    # 
+    def event_subscriptions_service
+      @event_subscriptions_service ||= EventSubscriptionsService.new(self, 'eventsubscriptions')
+    end
+    
     # 
     # Locates the `groups` service.
     # 
@@ -28403,6 +28974,12 @@ module OvirtSDK4
       if path.nil? || path == ''
         return self
       end
+      if path == 'eventsubscriptions'
+        return event_subscriptions_service
+      end
+      if path.start_with?('eventsubscriptions/')
+        return event_subscriptions_service.service(path[19..-1])
+      end
       if path == 'groups'
         return groups_service
       end
@@ -28601,7 +29178,7 @@ module OvirtSDK4
       if index.nil?
         return user_service(path)
       end
-      return user_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return user_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -28767,7 +29344,7 @@ module OvirtSDK4
       if index.nil?
         return network_service(path)
       end
-      return network_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return network_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -28815,6 +29392,8 @@ module OvirtSDK4
     
     CLONE = [
       [:async, TrueClass].freeze,
+      [:discard_snapshots, TrueClass].freeze,
+      [:storage_domain, StorageDomain].freeze,
       [:vm, Vm].freeze,
     ].freeze
     
@@ -28827,6 +29406,11 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the clone should be performed asynchronously.
     # 
+    # @option opts [Boolean] :discard_snapshots Use the `discard_snapshots` parameter when the virtual machine should be clone with its
+    #   snapshots collapsed. Default is true.
+    # 
+    # @option opts [StorageDomain] :storage_domain The storage domain on which the virtual machines disks will be copied to.
+    # 
     # @option opts [Vm] :vm 
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -29441,6 +30025,7 @@ module OvirtSDK4
     
     SHUTDOWN = [
       [:async, TrueClass].freeze,
+      [:reason, String].freeze,
     ].freeze
     
     private_constant :SHUTDOWN
@@ -29467,6 +30052,9 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the shutdown should be performed asynchronously.
     # 
+    # @option opts [String] :reason The reason the virtual machine was stopped.
+    #   Optionally set by user when shutting down the virtual machine.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -29486,6 +30074,7 @@ module OvirtSDK4
       [:filter, TrueClass].freeze,
       [:pause, TrueClass].freeze,
       [:use_cloud_init, TrueClass].freeze,
+      [:use_ignition, TrueClass].freeze,
       [:use_initialization, TrueClass].freeze,
       [:use_sysprep, TrueClass].freeze,
       [:vm, Vm].freeze,
@@ -29527,6 +30116,9 @@ module OvirtSDK4
     # @option opts [Boolean] :use_cloud_init If set to `true`, the initialization type is set to _cloud-init_. The default value is `false`.
     #   See https://cloudinit.readthedocs.io/en/latest[this] for details.
     # 
+    # @option opts [Boolean] :use_ignition If set to `true`, the initialization type is set to _Ignition_. The default value is `false`.
+    #   See https://coreos.com/ignition/docs/latest/[this] for details.
+    # 
     # @option opts [Boolean] :use_initialization If set to `true`, the initialization type is set by the VM's OS.
     #   Windows will set to _Sysprep_, Linux to _cloud-init_ and RedHat CoreOS to _Ignition_.
     #   If any of the initialization-types are explicitly set (useCloudInit, useSysprep or useIgnition),
@@ -29576,6 +30168,7 @@ module OvirtSDK4
     
     STOP = [
       [:async, TrueClass].freeze,
+      [:reason, String].freeze,
     ].freeze
     
     private_constant :STOP
@@ -29602,6 +30195,9 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the stop action should be performed asynchronously.
     # 
+    # @option opts [String] :reason The reason the virtual machine was stopped.
+    #   Optionally set by user when shutting down the virtual machine.
+    # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
     # @option opts [Hash] :query ({}) Additional URL query parameters.
@@ -30303,7 +30899,7 @@ module OvirtSDK4
       if index.nil?
         return application_service(path)
       end
-      return application_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return application_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -30502,7 +31098,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -30633,7 +31229,7 @@ module OvirtSDK4
       if index.nil?
         return backup_service(path)
       end
-      return backup_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return backup_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -30882,7 +31478,7 @@ module OvirtSDK4
       if index.nil?
         return cdrom_service(path)
       end
-      return cdrom_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return cdrom_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -31251,7 +31847,7 @@ module OvirtSDK4
       if index.nil?
         return disk_service(path)
       end
-      return disk_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return disk_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -31645,7 +32241,7 @@ module OvirtSDK4
       if index.nil?
         return console_service(path)
       end
-      return console_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return console_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -31873,7 +32469,7 @@ module OvirtSDK4
       if index.nil?
         return device_service(path)
       end
-      return device_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return device_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -32264,7 +32860,7 @@ module OvirtSDK4
       if index.nil?
         return nic_service(path)
       end
-      return nic_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return nic_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -32513,7 +33109,7 @@ module OvirtSDK4
       if index.nil?
         return node_service(path)
       end
-      return node_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return node_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -32864,7 +33460,7 @@ module OvirtSDK4
       if index.nil?
         return pool_service(path)
       end
-      return pool_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return pool_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -32978,7 +33574,7 @@ module OvirtSDK4
       if index.nil?
         return reported_device_service(path)
       end
-      return reported_device_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return reported_device_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -33116,7 +33712,7 @@ module OvirtSDK4
       if index.nil?
         return session_service(path)
       end
-      return session_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return session_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -33371,7 +33967,7 @@ module OvirtSDK4
       if index.nil?
         return watchdog_service(path)
       end
-      return watchdog_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return watchdog_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -34006,7 +34602,7 @@ module OvirtSDK4
       if index.nil?
         return vm_service(path)
       end
-      return vm_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return vm_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -34281,7 +34877,7 @@ module OvirtSDK4
       if index.nil?
         return profile_service(path)
       end
-      return profile_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return profile_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -34453,7 +35049,7 @@ module OvirtSDK4
       if index.nil?
         return weight_service(path)
       end
-      return weight_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return weight_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -35138,10 +35734,19 @@ module OvirtSDK4
     private_constant :UPDATE
     
     # 
-    # This operation updates the disk with the appropriate parameters.
-    # The only field that can be updated is `qcow_version`.
+    # Updates the parameters of the specified disk.
+    # 
+    # This operation allows updating the following floating disk properties:
+    # 
+    # * For Image disks: `provisioned_size`, `alias`, `description`, `wipe_after_delete`, `shareable`, `backup` and `disk_profile`.
+    # 
+    # * For LUN disks: `alias`, `description` and `shareable`.
     # 
-    # For example, disk update can be done using the following request:
+    # * For Cinder and Managed Block disks: `provisioned_size`, `alias` and `description`.
+    # 
+    # * For VM attached disks, the `qcow_version` can also be updated.
+    # 
+    # For example, a disk's update can be done by using the following request:
     # 
     # [source]
     # ----
@@ -35154,6 +35759,8 @@ module OvirtSDK4
     # ----
     # <disk>
     #   <qcow_version>qcow2_v3</qcow_version>
+    #   <alias>new-alias</alias>
+    #   <description>new-desc</description>
     # </disk>
     # ----
     # 
@@ -35316,7 +35923,7 @@ module OvirtSDK4
       if index.nil?
         return katello_erratum_service(path)
       end
-      return katello_erratum_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+      return katello_erratum_service(path[0..(index - 1)]).service(path[(index + 1)..-1])
     end
     
   end
@@ -36408,6 +37015,51 @@ module OvirtSDK4
       internal_action(:commitnetconfig, nil, COMMIT_NET_CONFIG, opts)
     end
     
+    COPY_HOST_NETWORKS = [
+      [:async, TrueClass].freeze,
+      [:source_host, Host].freeze,
+    ].freeze
+    
+    private_constant :COPY_HOST_NETWORKS
+    
+    # 
+    # Copy the network configuration of the specified host to current host.
+    # 
+    # To copy networks from another host, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts/123/copyhostnetworks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #    <sourceHost id="456" />
+    # </action>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
+    # 
+    # @option opts [Host] :source_host The host to copy networks from.
+    # 
+    # @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 copy_host_networks(opts = {})
+      internal_action(:copyhostnetworks, nil, COPY_HOST_NETWORKS, opts)
+    end
+    
     DEACTIVATE = [
       [:async, TrueClass].freeze,
       [:reason, String].freeze,
@@ -36471,6 +37123,7 @@ module OvirtSDK4
     FENCE = [
       [:async, TrueClass].freeze,
       [:fence_type, String].freeze,
+      [:maintenance_after_restart, TrueClass].freeze,
     ].freeze
     
     private_constant :FENCE
@@ -36510,6 +37163,8 @@ module OvirtSDK4
     # 
     # @option opts [String] :fence_type 
     # 
+    # @option opts [Boolean] :maintenance_after_restart Indicates if host should be put into maintenance after restart.
+    # 
     # @option opts [PowerManagement] :power_management 
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -36658,7 +37313,7 @@ module OvirtSDK4
     # "https://engine.example.com/ovirt-engine/api/hosts/123"
     # ----
     # 
-    # Example of installing a host, using `curl` and JSON, with hosted engine components:
+    # Example of installing a host using `curl` and JSON with hosted engine components:
     # 
     # [source,bash]
     # ----
@@ -36679,7 +37334,7 @@ module OvirtSDK4
     # "https://engine.example.com/ovirt-engine/api/hosts/123?deploy_hosted_engine=true"
     # ----
     # 
-    # IMPORTANT: Since version 4.1.2 of the engine when a host is reinstalled we override the host firewall
+    # IMPORTANT: Since version 4.1.2 of the engine, when a host is reinstalled we override the host firewall
     # definitions by default.
     # 
     # @param opts [Hash] Additional options.
@@ -36690,8 +37345,8 @@ module OvirtSDK4
     # 
     # @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
-    #   is treated as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in the
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true` this host will also deploy the self-hosted engine components. A missing value
+    #   is treated as `true` i.e deploy. Omitting this parameter means `false` and will not perform any operation in the
     #   self-hosted engine area.
     # 
     # @option opts [Host] :host The `override_iptables` property is used to indicate if the firewall configuration should be replaced by the
@@ -36699,13 +37354,13 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
-    # @option opts [String] :root_password The password of of the `root` user, used to connect to the host via SSH.
+    # @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.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy the self-hosted engine components and this host will
-    #   not function as part of the High Availability cluster. A missing value is treated as `true` i.e un-deploy
-    #   Omitting this parameter means `false` and will perform no operation in the self-hosted engine area.
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` this host will un-deploy the self-hosted engine components, and this host will
+    #   not function as part of the High Availability cluster. A missing value is treated as `true` i.e un-deploy.
+    #   Omitting this parameter means `false` and will not perform any operation in the self-hosted engine area.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -36995,7 +37650,7 @@ module OvirtSDK4
     # <ip address="192.168.122.10" netmask="255.255.255.0"/>
     # ----
     # 
-    # Using the Python SDK the same can be done with the following code:
+    # The same thing can be done using the Python SDK with the following code:
     # 
     # [source,python]
     # ----
@@ -37252,13 +37907,12 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the upgrade should be performed asynchronously.
     # 
-    # @option opts [String] :image The image parameter specifies path to image, which is used for upgrade. This parameter is used only to
-    #   upgrade Vintage Node hosts and it is not relevant for other hosts types.
+    # @option opts [String] :image This property is no longer relevant, since Vintage Node is no longer supported, and has been deprecated.
     # 
-    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after upgrade.
+    # @option opts [Boolean] :reboot Indicates if the host should be rebooted after the upgrade.
     #   By default the host is rebooted.
     #   
-    #   NOTE: This parameter is ignored for {hypervisor-name}, which is always rebooted after upgrade.
+    #   NOTE: This parameter is ignored for {hypervisor-name}, which is always rebooted after the upgrade.
     # 
     # @option opts [Integer] :timeout Upgrade timeout.
     #   
@@ -37366,8 +38020,8 @@ module OvirtSDK4
     # 
     # @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
-    #   is treated as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in the
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true` this host will also deploy the self-hosted engine components. A missing value
+    #   is treated as `true` i.e deploy. Omitting this parameter means `false` and will not perform any operation in the
     #   self-hosted engine area.
     # 
     # @option opts [Host] :host The `override_iptables` property is used to indicate if the firewall configuration should be replaced by the
@@ -37375,13 +38029,13 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
-    # @option opts [String] :root_password The password of of the `root` user, used to connect to the host via SSH.
+    # @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.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy the self-hosted engine components and this host will
-    #   not function as part of the High Availability cluster. A missing value is treated as `true` i.e un-deploy
-    #   Omitting this parameter means `false` and will perform no operation in the self-hosted engine area.
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` this host will un-deploy the self-hosted engine components, and this host will
+    #   not function as part of the High Availability cluster. A missing value is treated as `true` i.e un-deploy.
+    #   Omitting this parameter means `false` and will not perform any operation in the self-hosted engine area.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -37488,8 +38142,8 @@ module OvirtSDK4
     # 
     # @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
-    #   is treated as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in the
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true` this host will also deploy the self-hosted engine components. A missing value
+    #   is treated as `true` i.e deploy. Omitting this parameter means `false` and will not perform any operation in the
     #   self-hosted engine area.
     # 
     # @option opts [Host] :host The `override_iptables` property is used to indicate if the firewall configuration should be replaced by the
@@ -37497,13 +38151,13 @@ module OvirtSDK4
     # 
     # @option opts [String] :image When installing {hypervisor-name}, an ISO image file is required.
     # 
-    # @option opts [String] :root_password The password of of the `root` user, used to connect to the host via SSH.
+    # @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.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy the self-hosted engine components and this host will
-    #   not function as part of the High Availability cluster. A missing value is treated as `true` i.e un-deploy
-    #   Omitting this parameter means `false` and will perform no operation in the self-hosted engine area.
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` this host will un-deploy the self-hosted engine components, and this host will
+    #   not function as part of the High Availability cluster. A missing value is treated as `true` i.e un-deploy.
+    #   Omitting this parameter means `false` and will not perform any operation in the self-hosted engine area.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     #