ovirt-engine-sdk 4.1.7 → 4.1.8

data/ext/ovirtsdk4c/ov_http_client.c

@@ -311,9 +311,17 @@ static void* ov_http_client_header_task(void* data) {
     /* We should always tell the library that we processed all the data: */
     context_ptr->result = context_ptr->size * context_ptr->nitems;
 
-    /* Remove trailing white space: */
+    /* The library provides the headers for all the responses it receives, including the responses for intermediate
+       requests used for authentication negotation. We are interested only in the headers of the last response, so
+       if the given data is the begin of a new response, we clear the headers hash. */
     length = context_ptr->result;
     buffer = context_ptr->buffer;
+    if (length >= 5 && strncmp("HTTP/", buffer, 5) == 0) {
+        rb_hash_clear(response_ptr->headers);
+        return NULL;
+    }
+
+    /* Remove trailing white space: */
     while (length > 0 && isspace(buffer[length - 1])) {
         length--;
     }

data/lib/ovirtsdk4/probe.rb

@@ -67,6 +67,45 @@ module OvirtSDK4
       end
     end
 
+    ENGINE_CERTIFICATE_PATH =
+      '/ovirt-engine/services/pki-resource?resource=engine-certificate&format=OPENSSH-PUBKEY'.freeze
+
+    #
+    # This class method receives a set of options that define the server to probe and returns a boolean value
+    # that represents whether an oVirt instance was detected.
+    #
+    # @param opts [Hash] The options used to create the probe.
+    #
+    # @option opts [String] :host The name or IP address of the host to probe.
+    #
+    # @option opts [Integer] :port (443) The port number to probe.
+    #
+    # @option opts [String] :log The logger where the log messages will be written.
+    #
+    # @option opts [Boolean] :debug (false) A boolean flag indicating if debug output should be generated. If the
+    #   values is `true` and the `log` parameter isn't `nil` then the data sent to and received from the server will
+    #   be written to the log. Be aware that user names and passwords will also be written, so handle with care.
+    #
+    # @option opts [String] :proxy_url A string containing the protocol, address and port number of the proxy server
+    #   to use to connect to the server. For example, in order to use the HTTP proxy `proxy.example.com` that is
+    #   listening on port `3128` the value should be `http://proxy.example.com:3128`. This is optional, and if not
+    #   given the connection will go directly to the server specified in the `url` parameter.
+    #
+    # @option opts [Integer] :timeout (0) Set a connection timeout, in seconds. If the value is 0 no timeout is set.
+    #
+    # @return [Boolean] Boolean value, `true` if an oVirt instance was detected.
+    #
+    def self.exists?(opts)
+      probe = nil
+      begin
+        opts[:insecure] = true
+        probe = Probe.new(opts)
+        probe.exists?
+      ensure
+        probe.close if probe
+      end
+    end
+
     #
     # Creates a new probe.
     #
@@ -117,6 +156,7 @@ module OvirtSDK4
       @proxy_url      = opts[:proxy_url]
       @proxy_username = opts[:proxy_username]
       @proxy_password = opts[:proxy_password]
+      @timeout        = opts[:timeout]
 
       # Create the HTTP client:
       @client = HttpClient.new(
@@ -128,7 +168,8 @@ module OvirtSDK4
         debug:          @debug,
         proxy_url:      @proxy_url,
         proxy_username: @proxy_username,
-        proxy_password: @proxy_password
+        proxy_password: @proxy_password,
+        timeout:        @timeout
       )
     end
 
@@ -145,6 +186,18 @@ module OvirtSDK4
       detect_version(path).map { |version| ProbeResult.new(version: version) }
     end
 
+    #
+    # Probes the server to detect if it has an ovirt instance running on it
+    #
+    # @return [Boolean] `true` if oVirt instance was detected, false otherwise
+    #
+    # @api private
+    #
+    def exists?
+      response = send(path: ENGINE_CERTIFICATE_PATH)
+      response.code == 200
+    end
+
     #
     # Releases the resources used by this probe.
     #
@@ -184,8 +237,8 @@ module OvirtSDK4
 
       # Set authentication:
       request.username = @username
-      request.password = @password
 
+      request.password = @password
       # Send the request and wait for the response:
       @client.send(request)
       response = @client.wait(request)

data/lib/ovirtsdk4/readers.rb

@@ -4171,6 +4171,8 @@ module OvirtSDK4
       object.flood_rate = value if not value.nil?
       value = reader.get_attribute('id')
       object.id = value if not value.nil?
+      value = reader.get_attribute('index')
+      object.index = value if not value.nil?
       value = reader.get_attribute('name')
       object.name = value if not value.nil?
       value = reader.get_attribute('origin')
@@ -4204,6 +4206,8 @@ module OvirtSDK4
           object.flood_rate = Reader.read_integer(reader)
         when 'id'
           object.id = Reader.read_string(reader)
+        when 'index'
+          object.index = Reader.read_integer(reader)
         when 'name'
           object.name = Reader.read_string(reader)
         when 'origin'

data/lib/ovirtsdk4/service.rb

@@ -288,7 +288,7 @@ module OvirtSDK4
       result = Future.new(@connection, request) do |response|
         raise response if response.is_a?(Exception)
         case response.code
-        when 200
+        when 200, 201, 202
           action = check_action(response)
           action.send(member) if member
         else

data/lib/ovirtsdk4/services.rb

@@ -959,20 +959,20 @@ module OvirtSDK4
     private_constant :ADD
     
     # 
-    # Add a virtual machine to the affinity group.
+    # Adds a virtual machine to the affinity group.
     # 
-    # For example, to add the virtual machine 000-000 to affinity group 123-456 send a request to:
+    # For example, to add the virtual machine `789` to the affinity group `456` of cluster `123`, send a request like
+    # this:
     # 
-    # [source]
-    # ----
-    # POST /ovirt-engine/api/clusters/000-000/affinitygroups/123-456/vms
-    # ----
+    # ....
+    # POST /ovirt-engine/api/clusters/123/affinitygroups/456/vms
+    # ....
     # 
     # With the following body:
     # 
     # [source,xml]
     # ----
-    # <vm id="000-000"/>
+    # <vm id="789"/>
     # ----
     # 
     # @param vm [Vm] The `vm` to add.
@@ -1003,6 +1003,8 @@ module OvirtSDK4
     # 
     # List all virtual machines assigned to this affinity group.
     # 
+    # The order of the returned virtual machines isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of virtual machines to return. If not specified, all the virtual machines are
@@ -1119,6 +1121,8 @@ module OvirtSDK4
     # 
     # List existing affinity groups.
     # 
+    # The order of the affinity groups results isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of affinity groups to return. If not specified all the affinity groups are returned.
@@ -1423,6 +1427,8 @@ module OvirtSDK4
     # 
     # List all hosts with the label.
     # 
+    # The order of the returned hosts isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -1591,7 +1597,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # List all vms with the label.
+    # List all virtual machines with the label.
+    # 
+    # The order of the returned virtual machines isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -1690,6 +1698,8 @@ module OvirtSDK4
     # 
     # Lists all labels present in the system.
     # 
+    # The order of the returned labels isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of labels to return. If not specified all the labels are returned.
@@ -1861,6 +1871,8 @@ module OvirtSDK4
     # 
     # Lists all labels that are attached to an entity.
     # 
+    # The order of the returned entities isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -2032,7 +2044,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List the CPU profiles assigned to the cluster.
+    # 
+    # The order of the returned CPU profiles isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -2206,7 +2220,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disk profiles assigned to the storage domain.
+    # 
+    # The order of the returned disk profiles isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -2383,6 +2399,8 @@ module OvirtSDK4
     # </permissions>
     # ----
     # 
+    # The order of the returned permissions isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -2450,7 +2468,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the roles assigned to the permission.
+    # 
+    # The order of the returned roles isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -2680,6 +2700,8 @@ module OvirtSDK4
     # </tags>
     # ----
     # 
+    # The order of the returned tags isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of tags to return. If not specified all the tags are returned.
@@ -2867,7 +2889,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of VNIC profiles assifned to the network.
+    # 
+    # The order of the returned VNIC profiles isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3096,7 +3120,7 @@ module OvirtSDK4
     private_constant :ADD
     
     # 
-    # Adds a new `storage_domain`.
+    # Attaches an existing storage domain to the data center.
     # 
     # @param storage_domain [StorageDomain] The `storage_domain` to add.
     # 
@@ -3124,7 +3148,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of storage domains attached to the data center.
+    # 
+    # The order of the returned storage domains isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3302,7 +3328,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of balance modules used by the scheduling policy.
+    # 
+    # The order of the returned balance modules isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3584,6 +3612,8 @@ module OvirtSDK4
     # </bookmarks>
     # ----
     # 
+    # The order of the returned bookmarks isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of bookmarks to return. If not specified all the bookmarks are returned.
@@ -4090,6 +4120,8 @@ module OvirtSDK4
     # </cluster_levels>
     # ----
     # 
+    # The order of the returned cluster levels isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -4300,6 +4332,8 @@ module OvirtSDK4
     # 
     # Lists the networks that are assigned to the cluster.
     # 
+    # The order of the returned clusters isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of networks to return. If not specified, all the networks are returned.
@@ -4419,7 +4453,10 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of clusters of the system.
+    # 
+    # The order of the returned clusters is guaranteed only if the `sortby` clause is included in the
+    # `search` parameter.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -4692,7 +4729,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of CPU profiles of the system.
+    # 
+    # The order of the returned list of CPU profiles isn't guranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -5218,6 +5257,8 @@ module OvirtSDK4
     # 
     # Lists networks in the data center.
     # 
+    # The order of the returned list of networks isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of networks to return. If not specified, all the networks are returned.
@@ -5392,6 +5433,9 @@ module OvirtSDK4
     # The data center also contains a link to the storage domains collection. The data center uses this collection to
     # attach storage domains from the storage domains main collection.
     # 
+    # The order of the returned list of data centers is guaranteed only if the `sortby` clause is included in the
+    # `search` parameter.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -5686,6 +5730,8 @@ module OvirtSDK4
     # 
     # List the disk that are attached to the virtual machine.
     # 
+    # The order of the returned list of disks attachments isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -5900,7 +5946,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disk profiles of the system.
+    # 
+    # The order of the returned list of disk profiles isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6047,7 +6095,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disk snapshots of the storage domain.
+    # 
+    # The order of the returned list of disk snapshots isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6279,6 +6329,9 @@ module OvirtSDK4
     # </disks>
     # ----
     # 
+    # The order of the returned list of disks is guaranteed only if the `sortby` clause is included in the
+    # `search` parameter.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -6521,7 +6574,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of groups.
+    # 
+    # The order of the returned list of groups isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6699,6 +6754,8 @@ module OvirtSDK4
     # </users>
     # ----
     # 
+    # The order of the returned list of users isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -6796,6 +6853,8 @@ module OvirtSDK4
     # </domains>
     # ----
     # 
+    # The order of the returned list of domains isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of domains to return. If not specified all the domains are returned.
@@ -7082,16 +7141,25 @@ module OvirtSDK4
     # * id="1" - The API logs in the admin user account.
     # * id="2" - The API logs out of the admin user account.
     # 
+    # The order of the returned list of events is always garanteed. If the `sortby` clause is included in the
+    # `search` parameter, then the events will be ordered according to that clause. If the `sortby` clause isn't
+    # included, then the events will be sorted by the numeric value of the `id` attribute, starting with the
+    # highest value. This, combined with the `max` parameter, simplifies obtaining the most recent event:
+    # 
+    # ....
+    # GET /ovirt-engine/api/events?max=1
+    # ....
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
     #   account. The default value is `true`, which means that case is taken into account. If you want to search
     #   ignoring case set it to `false`.
     # 
-    # @option opts [Integer] :from Indicates the identifier of the the first event that should be returned. The identifiers of events are
-    #   strictly increasing, so when this parameter is used only the events with that identifiers equal or greater
-    #   than the given value will be returned. For example, the following request will return only the events
-    #   with identifiers greater or equal than `123`:
+    # @option opts [Integer] :from Indicates the event index after which events should be returned. The indexes of events are
+    #   strictly increasing, so when this parameter is used only the events with greater indexes
+    #   will be returned. For example, the following request will return only the events
+    #   with indexes greater than `123`:
     #   
     #   [source]
     #   ----
@@ -7249,7 +7317,26 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves external compute resource details.
+    # 
+    # For example, to get the details of compute resource `234` of provider `123`, send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/externalhostproviders/123/computeresources/234
+    # ....
+    # 
+    # It will return a response like this:
+    # 
+    # [source,xml]
+    # ----
+    # <external_compute_resource href="/ovirt-engine/api/externalhostproviders/123/computeresources/234" id="234">
+    #   <name>hostname</name>
+    #   <provider>oVirt</provider>
+    #   <url>https://hostname/api</url>
+    #   <user>admin@internal</user>
+    #   <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    # </external_compute_resource>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7302,7 +7389,31 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves a list of external compute resources.
+    # 
+    # For example, to retrieve the compute resources of external host provider `123`, send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/externalhostproviders/123/computeresources
+    # ....
+    # 
+    # It will return a response like this:
+    # 
+    # [source,xml]
+    # ----
+    # <external_compute_resources>
+    #   <external_compute_resource href="/ovirt-engine/api/externalhostproviders/123/computeresources/234" id="234">
+    #     <name>hostname</name>
+    #     <provider>oVirt</provider>
+    #     <url>https://address/api</url>
+    #     <user>admin@internal</user>
+    #     <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    #    </external_compute_resource>
+    #    ...
+    # </external_compute_resources>
+    # ----
+    # 
+    # The order of the returned list of compute resources isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7324,7 +7435,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `resource` service.
+    # This service manages compute resource instance
     # 
     # @param id [String] The identifier of the `resource`.
     # 
@@ -7371,7 +7482,30 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get discovered host info.
+    # 
+    # Retrieves information about an host that is managed in external provider management system, such as Foreman. The
+    # information includes hostname, address, subnet, base image and more.
+    # 
+    # For example, to get the details of host `234` from provider `123`, send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/externalhostproviders/123/discoveredhosts/234
+    # ....
+    # 
+    # The result will be like this:
+    # 
+    # [source,xml]
+    # ----
+    # <external_discovered_host href="/ovirt-engine/api/externalhostproviders/123/discoveredhosts/234" id="234">
+    #  <name>mac001a4ad04040</name>
+    #  <ip>10.34.67.43</ip>
+    #  <last_report>2017-04-24 11:05:41 UTC</last_report>
+    #  <mac>00:1a:4a:d0:40:40</mac>
+    #  <subnet_name>sat0</subnet_name>
+    #  <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    # </external_discovered_host>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7424,7 +7558,41 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get list of discovered hosts' information.
+    # 
+    # Discovered hosts are fetched from third-party providers such as Foreman.
+    # 
+    # To list all discovered hosts for provider `123` send the following:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/externalhostproviders/123/discoveredhost
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <external_discovered_hosts>
+    #  <external_discovered_host href="/ovirt-engine/api/externalhostproviders/123/discoveredhosts/456" id="456">
+    #   <name>mac001a4ad04031</name>
+    #   <ip>10.34.67.42</ip>
+    #   <last_report>2017-04-24 11:05:41 UTC</last_report>
+    #   <mac>00:1a:4a:d0:40:31</mac>
+    #   <subnet_name>sat0</subnet_name>
+    #   <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    #  </external_discovered_host>
+    #  <external_discovered_host href="/ovirt-engine/api/externalhostproviders/123/discoveredhosts/789" id="789">
+    #   <name>mac001a4ad04040</name>
+    #   <ip>10.34.67.43</ip>
+    #   <last_report>2017-04-24 11:05:41 UTC</last_report>
+    #   <mac>00:1a:4a:d0:40:40</mac>
+    #   <subnet_name>sat0</subnet_name>
+    #   <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    #  </external_discovered_host>
+    #  ...
+    # </external_discovered_hosts>
+    # ----
+    # 
+    # The order of the returned list of hosts isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7545,7 +7713,27 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get host group information.
+    # 
+    # For example, to get the details of hostgroup `234` of provider `123`, send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/externalhostproviders/123/hostgroups/234
+    # ....
+    # 
+    # It will return a response like this:
+    # 
+    # [source,xml]
+    # ----
+    # <external_host_group href="/ovirt-engine/api/externalhostproviders/123/hostgroups/234" id="234">
+    #   <name>rhel7</name>
+    #   <architecture_name>x86_64</architecture_name>
+    #   <domain_name>s.com</domain_name>
+    #   <operating_system_name>RedHat 7.3</operating_system_name>
+    #   <subnet_name>sat0</subnet_name>
+    #   <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    # </external_host_group>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7598,7 +7786,35 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get host groups list from external host provider.
+    # 
+    # Host group is a term of host providers - the host group includes provision details. This API returns all possible
+    # hostgroups exposed by the external provider.
+    # 
+    # For example, to get the details of all host groups of provider `123`, send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/externalhostproviders/123/hostgroups
+    # ....
+    # 
+    # The response will be like this:
+    # 
+    # [source,xml]
+    # ----
+    # <external_host_groups>
+    #   <external_host_group href="/ovirt-engine/api/externalhostproviders/123/hostgroups/234" id="234">
+    #     <name>rhel7</name>
+    #     <architecture_name>x86_64</architecture_name>
+    #     <domain_name>example.com</domain_name>
+    #     <operating_system_name>RedHat 7.3</operating_system_name>
+    #     <subnet_name>sat0</subnet_name>
+    #     <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123"/>
+    #   </external_host_group>
+    #   ...
+    # </external_host_groups>
+    # ----
+    # 
+    # The order of the returned list of host groups isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7620,7 +7836,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `group` service.
+    # This service manages hostgroup instance.
     # 
     # @param id [String] The identifier of the `group`.
     # 
@@ -7695,7 +7911,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of external host providers.
+    # 
+    # The order of the returned list of host providers isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7765,7 +7983,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Return the list of external hosts.
+    # 
+    # The order of the returned list of hosts isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7849,7 +8069,13 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `test_connectivity` method.
+    # In order to test connectivity for external provider we need
+    # to run following request where 123 is an id of a provider.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/externalhostproviders/123/testconnectivity
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7869,7 +8095,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `certificates` service.
+    # A service to view certificates for this external provider.
     # 
     # @return [ExternalProviderCertificatesService] A reference to `certificates` service.
     # 
@@ -7916,7 +8142,23 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get specific certificate.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/externalhostproviders/123/certificate/0
+    # ----
+    # 
+    # And here is sample response:
+    # 
+    # [source,xml]
+    # ----
+    # <certificate id="0">
+    #   <organization>provider.example.com</organization>
+    #   <subject>CN=provider.example.com</subject>
+    #   <content>...</content>
+    # </certificate>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7969,7 +8211,25 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the chain of certificates presented by the external provider.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/externalhostproviders/123/certificates
+    # ----
+    # 
+    # And here is sample response:
+    # 
+    # [source,xml]
+    # ----
+    # <certificates>
+    #   <certificate id="789">...</certificate>
+    #   ...
+    # </certificates>
+    # ----
+    # 
+    # The order of the returned certificates is always guaranteed to be the sign order: the first is the
+    # certificate of the server itself, the second the certificate of the CA that signs the first, so on.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7991,7 +8251,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `certificate` service.
+    # Reference to service that manages a specific certificate
+    # for this external provider.
     # 
     # @param id [String] The identifier of the `certificate`.
     # 
@@ -8119,7 +8380,27 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets details of this fence agent.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/hosts/123/fenceagents/0
+    # ----
+    # 
+    # And here is sample response:
+    # 
+    # [source,xml]
+    # ----
+    # <agent id="0">
+    #   <type>apc</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>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -8145,7 +8426,12 @@ module OvirtSDK4
     private_constant :REMOVE
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a fence agent for a specific host.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/hosts/123/fenceagents/0
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -8172,7 +8458,7 @@ module OvirtSDK4
     # 
     # Updates the `agent`.
     # 
-    # @param agent [Agent] The `agent` to update.
+    # @param agent [Agent] Fence agent details.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -8253,7 +8539,31 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of fencing agents configured for the host.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/hosts/123/fenceagents
+    # ----
+    # 
+    # And here is sample response:
+    # 
+    # [source,xml]
+    # ----
+    # <agents>
+    #   <agent id="0">
+    #     <type>apc</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>
+    # </agents>
+    # ----
+    # 
+    # The order of the returned list of fencing agents isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -8275,7 +8585,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `agent` service.
+    # Reference to service that manages a specific fence agent
+    # for this host.
     # 
     # @param id [String] The identifier of the `agent`.
     # 
@@ -8377,7 +8688,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of ISO images and virtual floppy disks available in the storage domain.
+    # 
+    # The order returned list of ISO images and virtual floppy disks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -8561,7 +8874,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of filters used by the scheduling policy.
+    # 
+    # The order of the returned list of filters isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -8764,6 +9079,8 @@ module OvirtSDK4
     # </bricks>
     # ----
     # 
+    # The order of the returned list is based on the brick order provided at gluster volume creation.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of bricks to return. If not specified all the bricks are returned.
@@ -9129,7 +9446,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of hooks.
+    # 
+    # The order of the returned list of hooks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9274,6 +9593,8 @@ module OvirtSDK4
     # GET /ovirt-engine/api/clusters/456/glustervolumes
     # ----
     # 
+    # The order of the returned list of volumes isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -9347,7 +9668,30 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the system group information.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/groups/123
+    # ....
+    # 
+    # Will return the group information:
+    # 
+    # [source,xml]
+    # ----
+    # <group href="/ovirt-engine/api/groups/123" id="123">
+    #   <name>mygroup</name>
+    #   <link href="/ovirt-engine/api/groups/123/roles" rel="roles"/>
+    #   <link href="/ovirt-engine/api/groups/123/permissions" rel="permissions"/>
+    #   <link href="/ovirt-engine/api/groups/123/tags" rel="tags"/>
+    #   <domain_entry_id>476652557A382F67696B6D2B32762B37796E46476D513D3D</domain_entry_id>
+    #   <namespace>DC=example,DC=com</namespace>
+    #   <domain href="/ovirt-engine/api/domains/ABCDEF" id="ABCDEF">
+    #     <name>myextension-authz</name>
+    #   </domain>
+    # </group>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9373,7 +9717,13 @@ module OvirtSDK4
     private_constant :REMOVE
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the system group.
+    # 
+    # Usage:
+    # 
+    # ....
+    # DELETE /ovirt-engine/api/groups/123
+    # ....
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9392,7 +9742,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Reference to the service that manages the collection of permissions assigned to this system group.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -9401,7 +9751,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `roles` service.
+    # Reference to the service that manages the collection of roles assigned to this system group.
     # 
     # @return [AssignedRolesService] A reference to `roles` service.
     # 
@@ -9410,7 +9760,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `tags` service.
+    # Reference to the service that manages the collection of tags assigned to this system group.
     # 
     # @return [AssignedTagsService] A reference to `tags` service.
     # 
@@ -9491,7 +9841,7 @@ module OvirtSDK4
     # </group>
     # ----
     # 
-    # @param group [Group] The `group` to add.
+    # @param group [Group] The group to be added.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9519,7 +9869,35 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all the groups in the system.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/groups
+    # ....
+    # 
+    # Will return the list of groups:
+    # 
+    # [source,xml]
+    # ----
+    # <groups>
+    #   <group href="/ovirt-engine/api/groups/123" id="123">
+    #     <name>mygroup</name>
+    #     <link href="/ovirt-engine/api/groups/123/roles" rel="roles"/>
+    #     <link href="/ovirt-engine/api/groups/123/permissions" rel="permissions"/>
+    #     <link href="/ovirt-engine/api/groups/123/tags" rel="tags"/>
+    #     <domain_entry_id>476652557A382F67696B6D2B32762B37796E46476D513D3D</domain_entry_id>
+    #     <namespace>DC=example,DC=com</namespace>
+    #     <domain href="/ovirt-engine/api/domains/ABCDEF" id="ABCDEF">
+    #       <name>myextension-authz</name>
+    #     </domain>
+    #   </group>
+    #   ...
+    # </groups>
+    # ----
+    # 
+    # The order of the returned list of groups isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9547,7 +9925,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `group` service.
+    # Reference to the service that manages a specific group.
     # 
     # @param id [String] The identifier of the `group`.
     # 
@@ -9668,6 +10046,8 @@ module OvirtSDK4
     # 
     # List the devices of a host.
     # 
+    # The order of the returned list of devices isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of devices to return. If not specified all the devices are returned.
@@ -9788,7 +10168,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of hooks configured for the host.
+    # 
+    # The order of the returned list of hooks isn't guranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9858,7 +10240,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of network interfaces of the host.
+    # 
+    # The order of the returned list of network interfaces isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9928,7 +10312,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of NUMA nodes of the host.
+    # 
+    # The order of the returned list of NUMA nodes isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -10017,6 +10403,8 @@ module OvirtSDK4
     # </host_storages>
     # ----
     # 
+    # The order of the returned list of storages isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :report_status Indicates if the status of the LUNs in the storage should be checked.
@@ -10199,6 +10587,7 @@ module OvirtSDK4
     end
     
     LIST = [
+      [:all_content, TrueClass].freeze,
       [:case_sensitive, TrueClass].freeze,
       [:filter, TrueClass].freeze,
       [:max, Integer].freeze,
@@ -10231,8 +10620,27 @@ module OvirtSDK4
     # </host>
     # ----
     # 
+    # The order of the returned list of hosts is guaranteed only if the `sortby` clause is included in
+    # the `search` parameter.
+    # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :all_content Indicates if all of the attributes of the hosts should be included in the response.
+    #   
+    #   By default the following host attributes are excluded:
+    #   
+    #   - `hosted_engine`
+    #   
+    #   For example, to retrieve the complete representation of the hosts:
+    #   
+    #   ....
+    #   GET /ovirt-engine/api/hosts?all_content=true
+    #   ....
+    #   
+    #   NOTE: These attributes are not included by default because retrieving them impacts performance. They are
+    #   seldom used and require additional queries to the database. Use this parameter with caution and only when
+    #   specifically required.
+    # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
     #   account. The default value is `true`, which means that case is taken into account. If you want to search
     #   ignoring case set it to `false`.
@@ -10394,6 +10802,8 @@ module OvirtSDK4
     # </icons>
     # ----
     # 
+    # The order of the returned list of icons isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of icons to return. If not specified all the icons are returned.
@@ -10731,6 +11141,8 @@ module OvirtSDK4
     # Retrieves the list of image transfers that are currently
     # being performed.
     # 
+    # The order of the returned list of image transfers isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -10798,7 +11210,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of images available in the storage domain or provider.
+    # 
+    # The order of the returned list of images isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11167,6 +11581,8 @@ module OvirtSDK4
     # 
     # Lists all the configured graphics consoles of the instance type.
     # 
+    # The order of the returned list of graphics consoles isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of consoles to return. If not specified all the consoles are returned.
@@ -11371,6 +11787,8 @@ module OvirtSDK4
     # 
     # Lists all the configured network interface of the instance type.
     # 
+    # The order of the returned list of network interfaces isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of NICs to return. If not specified all the NICs are returned.
@@ -11577,6 +11995,8 @@ module OvirtSDK4
     # 
     # Lists all the configured watchdogs of the instance type.
     # 
+    # The order of the returned list of watchdogs isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of watchdogs to return. If not specified all the watchdogs are
@@ -11763,6 +12183,8 @@ module OvirtSDK4
     # 
     # Lists all existing instance types in the system.
     # 
+    # The order of the returned list of instance types isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed
@@ -12050,7 +12472,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of iSCSI bonds configured in the data center.
+    # 
+    # The order of the returned list of iSCSI bonds isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12244,6 +12668,8 @@ module OvirtSDK4
     # 
     # List all the steps of the job.
     # 
+    # The order of the returned list of steps isn't guaranteed.
+    # 
     # @return [StepsService] A reference to `steps` service.
     # 
     def steps_service
@@ -12385,6 +12811,8 @@ module OvirtSDK4
     # </jobs>
     # ----
     # 
+    # The order of the returned list of jobs isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of jobs to return. If not specified all the jobs are returned.
@@ -12484,6 +12912,8 @@ module OvirtSDK4
     # </katello_errata>
     # ----
     # 
+    # The order of the returned list of erratum isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of errata to return. If not specified all the errata are returned.
@@ -12828,7 +13258,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Return the list of MAC address pools of the system.
+    # 
+    # The returned list of MAC address pools isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13353,7 +13785,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of network attachments of the host or host NIC.
+    # 
+    # The order of the returned list of network attachments isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13476,6 +13910,8 @@ module OvirtSDK4
     # 
     # Retrieves the representations of the network filters.
     # 
+    # The order of the returned list of network filters isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -13670,7 +14106,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of labels attached to the network or host NIC.
+    # 
+    # The order of the returned list of labels isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13836,6 +14274,9 @@ module OvirtSDK4
     # </networks>
     # ----
     # 
+    # The order of the returned list of networks is guaranteed only if the `sortby` clause is included in the
+    # `search` parameter.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -14079,7 +14520,13 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `test_connectivity` method.
+    # In order to test connectivity for external provider we need
+    # to run following request where 123 is an id of a provider.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/externalhostproviders/123/testconnectivity
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14128,7 +14575,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `certificates` service.
+    # A service to view certificates for this external provider.
     # 
     # @return [ExternalProviderCertificatesService] A reference to `certificates` service.
     # 
@@ -14218,7 +14665,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of providers.
+    # 
+    # The order of the returned list of providers isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14290,6 +14739,8 @@ module OvirtSDK4
     # 
     # Lists the images of a Glance image storage domain.
     # 
+    # The order of the returned list of images isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of images to return. If not specified all the images are returned.
@@ -14529,7 +14980,13 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `test_connectivity` method.
+    # In order to test connectivity for external provider we need
+    # to run following request where 123 is an id of a provider.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/externalhostproviders/123/testconnectivity
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14599,7 +15056,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `certificates` service.
+    # A service to view certificates for this external provider.
     # 
     # @return [ExternalProviderCertificatesService] A reference to `certificates` service.
     # 
@@ -14690,7 +15147,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of providers.
+    # 
+    # The order of the returned list of providers isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14760,7 +15219,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of networks.
+    # 
+    # The order of the returned list of networks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14934,7 +15395,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of sub-networks.
+    # 
+    # The order of the returned list of sub-networks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -15134,7 +15597,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of authentication keys.
+    # 
+    # The order of the returned list of authentication keys isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -15268,7 +15733,13 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `test_connectivity` method.
+    # In order to test connectivity for external provider we need
+    # to run following request where 123 is an id of a provider.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/externalhostproviders/123/testconnectivity
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -15326,7 +15797,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `certificates` service.
+    # A service to view certificates for this external provider.
     # 
     # @return [ExternalProviderCertificatesService] A reference to `certificates` service.
     # 
@@ -15448,6 +15919,8 @@ module OvirtSDK4
     # 
     # Retrieves the list of volume providers.
     # 
+    # The order of the returned list of volume providers isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of providers to return. If not specified all the providers are returned.
@@ -15568,7 +16041,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of volume types.
+    # 
+    # The order of the returned list of volume types isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -15690,7 +16165,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of types of operating system available in the system.
+    # 
+    # The order of the returned list of operating systems isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16002,6 +16479,8 @@ module OvirtSDK4
     # </permits>
     # ----
     # 
+    # The order of the returned list of permits isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of permits to return. If not specified all the permits are returned.
@@ -16069,7 +16548,26 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get specified QoS in the data center.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/datacenters/123/qoss/123
+    # ----
+    # 
+    # You will get response like this one below:
+    # 
+    # [source,xml]
+    # ----
+    # <qos href="/ovirt-engine/api/datacenters/123/qoss/123" id="123">
+    #   <name>123</name>
+    #   <description>123</description>
+    #   <max_iops>1</max_iops>
+    #   <max_throughput>1</max_throughput>
+    #   <type>storage</type>
+    #   <data_center href="/ovirt-engine/api/datacenters/123" id="123"/>
+    # </qos>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16095,7 +16593,12 @@ module OvirtSDK4
     private_constant :REMOVE
     
     # 
-    # Deletes the object managed by this service.
+    # Remove specified QoS from datacenter.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/datacenters/123/qoss/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16120,9 +16623,37 @@ module OvirtSDK4
     private_constant :UPDATE
     
     # 
-    # Updates the `qos`.
+    # Update the specified QoS in the dataCenter.
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/datacenters/123/qoss/123
+    # ----
+    # 
+    # For example with curl:
     # 
-    # @param qos [Qos] The `qos` to update.
+    # [source]
+    # ----
+    # curl -u admin@internal:123456 -X PUT -H "content-type: application/xml" -d \
+    # "<qos><name>321</name><description>321</description><max_iops>10</max_iops></qos>" \
+    # https://engine/ovirt-engine/api/datacenters/123/qoss/123
+    # ----
+    # 
+    # You will receive response like this:
+    # 
+    # [source,xml]
+    # ----
+    # <qos href="/ovirt-engine/api/datacenters/123/qoss/123" id="123">
+    #   <name>321</name>
+    #   <description>321</description>
+    #   <max_iops>10</max_iops>
+    #   <max_throughput>1</max_throughput>
+    #   <type>storage</type>
+    #   <data_center href="/ovirt-engine/api/datacenters/123" id="123"/>
+    # </qos>
+    # ----
+    # 
+    # @param qos [Qos] Updated QoS object.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -16203,7 +16734,25 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of _quality of service_ configurations available in the data center.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/datacenter/123/qoss
+    # ----
+    # 
+    # You will get response which will look like this:
+    # 
+    # [source, xml]
+    # ----
+    # <qoss>
+    #   <qos href="/ovirt-engine/api/datacenters/123/qoss/1" id="1">...</qos>
+    #   <qos href="/ovirt-engine/api/datacenters/123/qoss/2" id="2">...</qos>
+    #   <qos href="/ovirt-engine/api/datacenters/123/qoss/3" id="3">...</qos>
+    # </qoss>
+    # ----
+    # 
+    # The returned list of quality of service configurations isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16574,7 +17123,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the set of quota limits configured for the cluster.
+    # 
+    # The returned list of quota limits isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16748,7 +17299,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of storage limits configured for the quota.
+    # 
+    # The order of the returned list of storage limits isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16860,7 +17413,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Lists quotas of a data center
+    # Lists quotas of a data center.
+    # 
+    # The order of the returned list of quotas isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17169,6 +17724,8 @@ module OvirtSDK4
     # </roles>
     # ----
     # 
+    # The order of the returned list of roles isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of roles to return. If not specified all the roles are returned.
@@ -17265,7 +17822,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of scheduling policies available in the system.
+    # 
+    # The order of the returned list of scheduling policies isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17572,7 +18131,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of scheduling policy units available in the system.
+    # 
+    # The order of the returned list of scheduling policy units isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17857,7 +18418,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of CD-ROM devices of the snapshot.
+    # 
+    # The order of the returned list of CD-ROM devices isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17979,7 +18542,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disks of the snapshot.
+    # 
+    # The order of the returned list of disks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18101,7 +18666,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of NICs of the snapshot.
+    # 
+    # The order of the returned list of NICs isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18231,7 +18798,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of snapshots of the storage domain or virtual machine.
+    # 
+    # The order of the returned list of snapshots isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18434,7 +19003,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns ths list of SSH public keys of the user.
+    # 
+    # The order of the returned list of keys isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18614,6 +19185,8 @@ module OvirtSDK4
     # </statistic>
     # ----
     # 
+    # The order of the returned list of statistics isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of statistics to return. If not specified all the statistics are returned.
@@ -18912,6 +19485,8 @@ module OvirtSDK4
     # </steps>
     # ----
     # 
+    # The order of the returned list of steps isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of steps to return. If not specified all the steps are returned.
@@ -19153,6 +19728,9 @@ module OvirtSDK4
     #  </action>
     # ----
     # 
+    #  Note that this operation is only applicable to block storage domains (i.e., storage domains with the
+    #  <<types/storage_type, storage type> of iSCSI or FCP).
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Array<LogicalUnit>] :logical_units The logical units that needs to be reduced from the storage domain.
@@ -19594,7 +20172,10 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disks available in the storage domain.
+    # 
+    # The order of the returned list of disks is guaranteed only if the `sortby` clause is included in
+    # the `search` parameter.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -19774,7 +20355,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of connections to storage servers that existin the storage domain.
+    # 
+    # The order of the returned list of connections isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20027,7 +20610,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of templates availalbe in the storage domain.
+    # 
+    # The order of the returned list of templates isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20417,6 +21002,8 @@ module OvirtSDK4
     # 
     # List the disks that are attached to the virtual machine.
     # 
+    # The order of the returned list of disk attachments isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -20484,7 +21071,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of virtual machines of the export storage domain.
+    # 
+    # The order of the returned list of virtual machines isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20667,7 +21256,10 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of storage domains of the system.
+    # 
+    # The order of the returned list of storage domains is guaranteed only if the `sortby` clause is included
+    # in the `search` parameter.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -21061,7 +21653,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list os storage connection extensions.
+    # 
+    # The order of the returned list of storage connections isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -21180,7 +21774,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of storage connections.
+    # 
+    # The order of the returned list of connections isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -22078,6 +22674,8 @@ module OvirtSDK4
     # </permissions>
     # ----
     # 
+    # The order of the returned permissions isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -22390,6 +22988,8 @@ module OvirtSDK4
     #     - root3  (id: 333)
     # ....
     # 
+    # The order of the returned list of tags isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of tags to return. If not specified all the tags are returned.
@@ -22810,7 +23410,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of CD-ROM devices of the template.
+    # 
+    # The order of the returned list of CD-ROM devices isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23090,6 +23692,8 @@ module OvirtSDK4
     # 
     # List the disks that are attached to the template.
     # 
+    # The order of the returned list of attachments isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
@@ -23156,7 +23760,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disks of the template.
+    # 
+    # The order of the returned list of disks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23332,6 +23938,8 @@ module OvirtSDK4
     # 
     # Lists all the configured graphics consoles of the template.
     # 
+    # The order of the returned list of graphics consoles isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of consoles to return. If not specified all the consoles are returned.
@@ -23533,7 +24141,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of NICs of the template.
+    # 
+    # The order of the returned list of NICs isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23736,7 +24346,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of watchdogs.
+    # 
+    # The order of the returned list of watchdogs isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23809,7 +24421,9 @@ module OvirtSDK4
     # 
     # Creates a new template.
     # 
-    # This requires the `name` and `vm` elements. Identify the virtual machine with the `id` `name` attributes.
+    # This requires the `name` and `vm` elements. To identify the virtual machine use the `vm.id` or `vm.name`
+    # attributes. For example, to create a template from virtual machine with identifier `123` send a request
+    # like this:
     # 
     # [source]
     # ----
@@ -23826,6 +24440,30 @@ module OvirtSDK4
     # </template>
     # ----
     # 
+    # The disks of the template can be customized, making some of their characteristics different to the disks of the
+    # original virtual machine. To do so use the `vm.disk_attachments` attribute, specifying the identifier of the disk
+    # of the original virtual machine and the characteristics that you want to change. For example, if the original
+    # virtual machine has a disk with identifier `456`, and, for that disk, you want to change the format to
+    # <<types/disk_format, _Copy On Write_>> and make the disk <<types/disk, sparse>>, send a request body
+    # like this:
+    # 
+    # [source,xml]
+    # ----
+    # <template>
+    #   <name>mytemplate</name>
+    #   <vm id="123">
+    #     <disk_attachments>
+    #       <disk_attachment>
+    #         <disk id="456">
+    #           <format>cow</format>
+    #           <sparse>true</sparse>
+    #         </disk>
+    #       </disk_attachment>
+    #     </disk_attachments>
+    #   </vm>
+    # </template>
+    # ----
+    # 
     # The template can be created as a sub version of an existing template.This requires the `name` and `vm` attributes
     # for the new template, and the `base_template` and `version_name` attributes for the new template version. The
     # `base_template` and `version_name` attributes must be specified within a `version` section enclosed in the
@@ -23918,6 +24556,8 @@ module OvirtSDK4
     # 
     # Will return the list of virtual machines and virtual machine templates.
     # 
+    # The order of the returned list of templates isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -24071,7 +24711,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of unmanaged networks of the host.
+    # 
+    # The order of the returned list of networks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -24410,6 +25052,8 @@ module OvirtSDK4
     # </users>
     # ----
     # 
+    # The order of the returned list of users isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -24588,7 +25232,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of networks.
+    # 
+    # The order of the returned list of networks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25826,6 +26472,8 @@ module OvirtSDK4
     # 
     # Returns a list of applications installed in the virtual machine.
     # 
+    # The order of the returned list of applications isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
@@ -26058,6 +26706,8 @@ module OvirtSDK4
     # 
     # Returns the list of CDROM devices of the virtual machine.
     # 
+    # The order of the returned list of CD-ROM devices isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of CDROMs to return. If not specified all the CDROMs are returned.
@@ -26377,7 +27027,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of disks of the virtual machine.
+    # 
+    # The order of the returned list of disks isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -26727,6 +27379,8 @@ module OvirtSDK4
     # 
     # Lists all the configured graphics consoles of the virtual machine.
     # 
+    # The order of the returned list of graphics consoles isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :current Use the following query to obtain the current run-time configuration of the graphics consoles.
@@ -26972,6 +27626,8 @@ module OvirtSDK4
     # 
     # List the host devices assigned to given virtual machine.
     # 
+    # The order of the returned list of devices isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of devices to return. If not specified all the devices are returned.
@@ -27343,7 +27999,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of NICs of the virtual machine.
+    # 
+    # The order of the returned list of NICs isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27599,6 +28257,8 @@ module OvirtSDK4
     # 
     # Lists virtual NUMA nodes of a virtual machine.
     # 
+    # The order of the returned list of NUMA nodes isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of nodes to return. If not specified all the nodes are returned.
@@ -27943,6 +28603,9 @@ module OvirtSDK4
     # </vm_pools>
     # ----
     # 
+    # The order of the returned list of pools is guaranteed only if the `sortby` clause is included in the
+    # `search` parameter.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :case_sensitive Indicates if the search performed using the `search` parameter should be performed taking case into
@@ -28071,7 +28734,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of reported devices of the virtual machine.
+    # 
+    # The order of the returned list of devices isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28219,6 +28884,8 @@ module OvirtSDK4
     # </sessions>
     # ----
     # 
+    # The order of the returned list of sessions isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of sessions to return. If not specified all the sessions are returned.
@@ -28482,6 +29149,8 @@ module OvirtSDK4
     # 
     # The list of watchdogs of the virtual machine.
     # 
+    # The order of the returned list of watchdogs isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of watchdogs to return. If not specified all the watchdogs are returned.
@@ -28792,7 +29461,10 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of virtual machines of the system.
+    # 
+    # The order of the returned list of virtual machines is guaranteed only if the `sortby` clause is included
+    # in the `search` parameter.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29102,6 +29774,8 @@ module OvirtSDK4
     # 
     # List all vNIC profiles.
     # 
+    # The order of the returned list of vNIC profiles isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of profiles to return. If not specified all the profiles are returned.
@@ -29278,7 +29952,9 @@ module OvirtSDK4
     private_constant :LIST
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of weights.
+    # 
+    # The order of the returned list of weights isn't guaranteed.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29622,6 +30298,8 @@ module OvirtSDK4
     # </katello_errata>
     # ----
     # 
+    # The order of the returned list of erratum isn't guaranteed.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Integer] :max Sets the maximum number of errata to return. If not specified all the errata are returned.
@@ -29690,7 +30368,28 @@ module OvirtSDK4
     private_constant :GET
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get external host provider information
+    # 
+    # Host provider, Foreman or Satellite, can be set as an external provider in ovirt. To see details about specific
+    # host providers attached to ovirt use this API.
+    # 
+    # For example, to get the details of host provider `123`, send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/externalhostproviders/123
+    # ....
+    # 
+    # The response will be like this:
+    # 
+    # [source,xml]
+    # ----
+    # <external_host_provider href="/ovirt-engine/api/externalhostproviders/123" id="123">
+    #   <name>mysatellite</name>
+    #   <requires_authentication>true</requires_authentication>
+    #   <url>https://mysatellite.example.com</url>
+    #   <username>admin</username>
+    # </external_host_provider>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29755,7 +30454,13 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `test_connectivity` method.
+    # In order to test connectivity for external provider we need
+    # to run following request where 123 is an id of a provider.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/externalhostproviders/123/testconnectivity
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29804,7 +30509,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `certificates` service.
+    # A service to view certificates for this external provider.
     # 
     # @return [ExternalProviderCertificatesService] A reference to `certificates` service.
     # 
@@ -30583,7 +31288,9 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the approval should be performed asynchronously.
     # 
-    # @option opts [Cluster] :cluster 
+    # @option opts [Cluster] :cluster Cluster where the host will be added after approving it.
+    # 
+    # @option opts [Host] :host Host to approve.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.
     # 
@@ -30767,6 +31474,7 @@ module OvirtSDK4
     end
     
     GET = [
+      [:all_content, TrueClass].freeze,
       [:filter, TrueClass].freeze,
     ].freeze
     
@@ -30775,8 +31483,29 @@ module OvirtSDK4
     # 
     # Get the host details.
     # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/hosts/123
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :all_content Indicates if all of the attributes of the host should be included in the response.
+    #   
+    #   By default the following attributes are excluded:
+    #   
+    #   - `hosted_engine`
+    #   
+    #   For example, to retrieve the complete representation of host '123':
+    #   
+    #   ....
+    #   GET /ovirt-engine/api/hosts/123?all_content=true
+    #   ....
+    #   
+    #   NOTE: These attributes are not included by default because retrieving them impacts performance. They are
+    #   seldom used and require additional queries to the database. Use this parameter with caution and only when
+    #   specifically required.
+    # 
     # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
     # 
     # @option opts [Hash] :headers ({}) Additional HTTP headers.