ovirt-engine-sdk 4.0.7 → 4.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 941838d3336897908d87d082d471f5aa63bc1302
-  data.tar.gz: 07eee0003584d83b43dbaf5f11c5b8dc7ce593e8
+  metadata.gz: 6b366c99ed9573af389d9ef85f6369e8b6c490ae
+  data.tar.gz: 2df99eef60a03608c252f38cdd4387003bef0385
 SHA512:
-  metadata.gz: 28756c56277fad2ed7b439ab0a12d61719e15d4636172dbb21fcf086d10afcc6777e40f05f2f437f6d1c4e510f26b524fa714775393ba31b3388d78ba4525b27
-  data.tar.gz: a094e808b259fd31d37d1bf8849f08e871dad46a863cd6817e2ac7249d92c45c3061f9bf0c2b56cb6d749e06ce689a31a676fc536cc06b722fcf66e9743d9eeb
+  metadata.gz: 576d84f2923bbcf61e60437acc23301b4b8189634f74ce133f443fd38cf1e74fe91f4a13ff6bab9a5fb6a8a956e690f9136ff0fe032c49aa0e6685ad3b9d55a7
+  data.tar.gz: b86cbc5412c5d77f88cfe2a4295e1ef7b8c2f340abbabea0fa51242907374544729b6d38ad263989b5a3e3496e30454bfefb7cb773fe8d00de2e37e8cef6df83

data/CHANGES.adoc

@@ -2,6 +2,16 @@
 
 This document describes the relevant changes between releases of the SDK.
 
+== 4.0.8 / Jan 27 2017
+
+Update to model 4.0.41:
+
+* Add `initial_size` attribute to the `Disk` type.
+
+New features:
+
+* Accept CA files and strings.
+
 == 4.0.7 / Jan 12 2017
 
 New features:

data/lib/ovirtsdk4/connection.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2015-2016 Red Hat, Inc.
+# Copyright (c) 2015-2017 Red Hat, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
 #
 
 require 'json'
+require 'tempfile'
 require 'uri'
 
 module OvirtSDK4
@@ -54,8 +55,14 @@ module OvirtSDK4
     #   name should be checked.
     #
     # @option opts [String] :ca_file The name of a PEM file containing the trusted CA certificates. The certificate
-    #   presented by the server will be verified using these CA certificates. If not set then the system wide CA
-    #   certificates store is used.
+    #   presented by the server will be verified using these CA certificates. If neither this nor the `ca_certs`
+    #   options are provided, then the system wide CA certificates store is used. If both options are provided,
+    #   then the certificates from both options will be trusted.
+    #
+    # @option opts [Array<String>] :ca_certs An array of strings containing the trusted CA certificates, in PEM
+    #   format. The certificate presented by the server will be verified using these CA certificates. If neither this
+    #   nor the `ca_file` options are provided, then the system wide CA certificates store is used. If both options
+    #   are provided, then the certificates from both options will be trusted.
     #
     # @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
@@ -91,6 +98,7 @@ module OvirtSDK4
       @token = opts[:token]
       @insecure = opts[:insecure] || false
       @ca_file = opts[:ca_file]
+      @ca_certs = opts[:ca_certs]
       @debug = opts[:debug] || false
       @log = opts[:log]
       @kerberos = opts[:kerberos] || false
@@ -100,10 +108,24 @@ module OvirtSDK4
       @proxy_username = opts[:proxy_username]
       @proxy_password = opts[:proxy_password]
 
+      # Create a temporary file to store the CA certificates, and populate it with the contents of the 'ca_file' and
+      # 'ca_certs' options. The file will be removed when the connection is closed.
+      @ca_store = nil
+      if @ca_file || @ca_certs
+        @ca_store = Tempfile.new('ca_store')
+        @ca_store.write(::File.read(@ca_file)) if @ca_file
+        if @ca_certs
+          @ca_certs.each do |ca_cert|
+            @ca_store.write(ca_cert)
+          end
+        end
+        @ca_store.close
+      end
+
       # Create the HTTP client:
       @client = HttpClient.new(
         insecure: @insecure,
-        ca_file: @ca_file,
+        ca_file: @ca_store ? @ca_store.path : nil,
         debug: @debug,
         log: @log,
         timeout: @timeout,
@@ -399,6 +421,9 @@ module OvirtSDK4
 
       # Close the HTTP client:
       @client.close if @client
+
+      # Remove the temporary file that contains the trusted CA certificates:
+      @ca_store.unlink if @ca_store
     end
   end
 end

data/lib/ovirtsdk4/readers.rb

@@ -2997,6 +2997,8 @@ module OvirtSDK4
       object.id = value if not value.nil?
       value = reader.get_attribute('image_id')
       object.image_id = value if not value.nil?
+      value = reader.get_attribute('initial_size')
+      object.initial_size = value if not value.nil?
       value = reader.get_attribute('interface')
       object.interface = value if not value.nil?
       value = reader.get_attribute('logical_name')
@@ -3050,6 +3052,8 @@ module OvirtSDK4
           object.id = Reader.read_string(reader)
         when 'image_id'
           object.image_id = Reader.read_string(reader)
+        when 'initial_size'
+          object.initial_size = Reader.read_integer(reader)
         when 'interface'
           object.interface = Reader.read_string(reader)
         when 'logical_name'
@@ -3389,6 +3393,8 @@ module OvirtSDK4
       object.id = value if not value.nil?
       value = reader.get_attribute('image_id')
       object.image_id = value if not value.nil?
+      value = reader.get_attribute('initial_size')
+      object.initial_size = value if not value.nil?
       value = reader.get_attribute('interface')
       object.interface = value if not value.nil?
       value = reader.get_attribute('logical_name')
@@ -3442,6 +3448,8 @@ module OvirtSDK4
           object.id = Reader.read_string(reader)
         when 'image_id'
           object.image_id = Reader.read_string(reader)
+        when 'initial_size'
+          object.initial_size = Reader.read_integer(reader)
         when 'interface'
           object.interface = Reader.read_string(reader)
         when 'logical_name'

data/lib/ovirtsdk4/services.rb

@@ -2791,9 +2791,66 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `permission`.
+    # Assign a new permission to a user or group for specific entity.
     # 
-    # @param permission [Permission] The `permission` to add.
+    # For example, to assign the `UserVmManager` role to the virtual machine with id `123` to the user with id `456`
+    # send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/vms/123/permissions
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permission>
+    #   <role>
+    #     <name>UserVmManager</name>
+    #   </role>
+    #   <user id="456"/>
+    # </permission>
+    # ----
+    # 
+    # To assign the `SuperUser` role to the system to the user with id `456` send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/permissions
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permission>
+    #   <role>
+    #     <name>SuperUser</name>
+    #   </role>
+    #   <user id="456"/>
+    # </permission>
+    # ----
+    # 
+    # If you want to assign permission to the group instead of the user please replace the `user` element with the
+    # `group` element with proper `id` of the group. For example to assign the `UserRole` role to the cluster with
+    # id `123` to the group with id `789` send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/clusters/123/permissions
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permission>
+    #   <role>
+    #     <name>UserRole</name>
+    #   </role>
+    #   <group id="789"/>
+    # </permission>
+    # ----
+    # 
+    # @param permission [Permission] The permission.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -2827,7 +2884,29 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all the permissions of the specific entity.
+    # 
+    # For example to list all the permissions of the cluster with id `123` send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/clusters/123/permissions
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <permissions>
+    #   <permission id="456">
+    #     <cluster id="123"/>
+    #     <role id="789"/>
+    #     <user id="451"/>
+    #   </permission>
+    #   <permission id="654">
+    #     <cluster id="123"/>
+    #     <role id="789"/>
+    #     <group id="127"/>
+    #   </permission>
+    # </permissions>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -2995,7 +3074,23 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the information about the assigned tag.
+    # 
+    # For example to retrieve the information about the tag with the id `456` which is assigned to virtual machine
+    # with id `123` send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/vms/123/tags/456
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <tag href="/ovirt-engine/api/tags/456" id="456">
+    #   <name>root</name>
+    #   <description>root</description>
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    # </tag>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3019,7 +3114,13 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Unassign tag from specific entity in the system.
+    # 
+    # For example to unassign the tag with id `456` from virtual machine with id `123` send a request like this:
+    # 
+    # ....
+    # DELETE /ovirt-engine/api/vms/123/tags/456
+    # ....
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3080,9 +3181,24 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `tag`.
+    # Assign tag to specific entity in the system.
     # 
-    # @param tag [Tag] The `tag` to add.
+    # For example to assign tag `mytag` to virtual machine with the id `123` send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/vms/123/tags
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <tag>
+    #   <name>mytag</name>
+    # </tag>
+    # ----
+    # 
+    # @param tag [Tag] The assigned tag.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3116,7 +3232,24 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all tags assigned to the specific entity.
+    # 
+    # For example to list all the tags of the virtual machine with id `123` send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/vms/123/tags
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <tags>
+    #   <tag href="/ovirt-engine/api/tags/222" id="222">
+    #     <name>mytag</name>
+    #     <description>mytag</description>
+    #     <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    #   </tag>
+    # </tags>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3147,7 +3280,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `tag` service.
+    # Reference to the service that manages assignment of specific tag.
     # 
     # @param id [String] The identifier of the `tag`.
     # 
@@ -3953,7 +4086,22 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get a bookmark.
+    # 
+    # An example for getting a bookmark:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/bookmarks/123
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <bookmark href="/ovirt-engine/api/bookmarks/123" id="123">
+    #   <name>example_vm</name>
+    #   <value>vm: name=example*</value>
+    # </bookmark>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3977,7 +4125,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove a bookmark.
+    # 
+    # An example for removing a bookmark:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/bookmarks/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3997,9 +4152,26 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `bookmark`.
+    # Update a bookmark.
     # 
-    # @param bookmark [Bookmark] The `bookmark` to update.
+    # An example for updating a bookmark:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/bookmarks/123
+    # ----
+    # 
+    # With the request body:
+    # 
+    # [source,xml]
+    # ----
+    # <bookmark>
+    #   <name>new_example_vm</name>
+    #   <value>vm: name=new_example*</value>
+    # </bookmark>
+    # ----
+    # 
+    # @param bookmark [Bookmark] The updated bookmark.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -4081,9 +4253,24 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `bookmark`.
+    # Adding a new bookmark.
+    # 
+    # Example of adding a bookmark:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/bookmarks
+    # ----
     # 
-    # @param bookmark [Bookmark] The `bookmark` to add.
+    # [source,xml]
+    # ----
+    # <bookmark>
+    #   <name>new_example_vm</name>
+    #   <value>vm: name=new_example*</value>
+    # </bookmark>
+    # ----
+    # 
+    # @param bookmark [Bookmark] The added bookmark.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -4117,7 +4304,28 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Listing all the available bookmarks.
+    # 
+    # Example of listing bookmarks:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/bookmarks
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <bookmarks>
+    #   <bookmark href="/ovirt-engine/api/bookmarks/123" id="123">
+    #     <name>database</name>
+    #     <value>vm: name=database*</value>
+    #   </bookmark>
+    #   <bookmark href="/ovirt-engine/api/bookmarks/456" id="456">
+    #     <name>example</name>
+    #     <value>vm: name=example*</value>
+    #   </bookmark>
+    # </bookmarks>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -4148,7 +4356,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `bookmark` service.
+    # A reference to the service managing a specific bookmark.
     # 
     # @param id [String] The identifier of the `bookmark`.
     # 
@@ -4204,7 +4412,85 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get information about the cluster.
+    # 
+    # An example of getting a cluster:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusters/123
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <cluster href="/ovirt-engine/api/clusters/123" id="123">
+    #   <actions>
+    #     <link href="/ovirt-engine/api/clusters/123/resetemulatedmachine" rel="resetemulatedmachine"/>
+    #   </actions>
+    #   <name>Default</name>
+    #   <description>The default server cluster</description>
+    #   <link href="/ovirt-engine/api/clusters/123/networks" rel="networks"/>
+    #   <link href="/ovirt-engine/api/clusters/123/permissions" rel="permissions"/>
+    #   <link href="/ovirt-engine/api/clusters/123/glustervolumes" rel="glustervolumes"/>
+    #   <link href="/ovirt-engine/api/clusters/123/glusterhooks" rel="glusterhooks"/>
+    #   <link href="/ovirt-engine/api/clusters/123/affinitygroups" rel="affinitygroups"/>
+    #   <link href="/ovirt-engine/api/clusters/123/cpuprofiles" rel="cpuprofiles"/>
+    #   <ballooning_enabled>false</ballooning_enabled>
+    #   <cpu>
+    #     <architecture>x86_64</architecture>
+    #     <type>Intel Penryn Family</type>
+    #   </cpu>
+    #   <error_handling>
+    #     <on_error>migrate</on_error>
+    #   </error_handling>
+    #   <fencing_policy>
+    #     <enabled>true</enabled>
+    #     <skip_if_connectivity_broken>
+    #       <enabled>false</enabled>
+    #       <threshold>50</threshold>
+    #     </skip_if_connectivity_broken>
+    #     <skip_if_sd_active>
+    #       <enabled>false</enabled>
+    #     </skip_if_sd_active>
+    #   </fencing_policy>
+    #   <gluster_service>false</gluster_service>
+    #   <ha_reservation>false</ha_reservation>
+    #   <ksm>
+    #     <enabled>true</enabled>
+    #     <merge_across_nodes>true</merge_across_nodes>
+    #   </ksm>
+    #   <maintenance_reason_required>false</maintenance_reason_required>
+    #   <memory_policy>
+    #     <over_commit>
+    #       <percent>100</percent>
+    #     </over_commit>
+    #     <transparent_hugepages>
+    #       <enabled>true</enabled>
+    #     </transparent_hugepages>
+    #   </memory_policy>
+    #   <migration>
+    #     <auto_converge>inherit</auto_converge>
+    #     <bandwidth>
+    #       <assignment_method>auto</assignment_method>
+    #     </bandwidth>
+    #     <compressed>inherit</compressed>
+    #   </migration>
+    #   <optional_reason>false</optional_reason>
+    #   <required_rng_sources>
+    #     <required_rng_source>random</required_rng_source>
+    #   </required_rng_sources>
+    #   <scheduling_policy href="/ovirt-engine/api/schedulingpolicies/456" id="456"/>
+    #   <threads_as_cores>false</threads_as_cores>
+    #   <trusted_service>false</trusted_service>
+    #   <tunnel_migration>false</tunnel_migration>
+    #   <version>
+    #     <major>4</major>
+    #     <minor>0</minor>
+    #   </version>
+    #   <virt_service>true</virt_service>
+    #   <data_center href="/ovirt-engine/api/datacenters/111" id="111"/>
+    # </cluster>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -4350,7 +4636,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `affinity_groups` service.
+    # Reference to the service that manages affinity groups.
     # 
     # @return [AffinityGroupsService] A reference to `affinity_groups` service.
     # 
@@ -4359,7 +4645,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `cpu_profiles` service.
+    # Reference to the service that manages assigned CPU profiles for cluster.
     # 
     # @return [AssignedCpuProfilesService] A reference to `cpu_profiles` service.
     # 
@@ -4368,7 +4654,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `gluster_hooks` service.
+    # Reference to the service that manages the Gluster hooks for cluster.
     # 
     # @return [GlusterHooksService] A reference to `gluster_hooks` service.
     # 
@@ -4377,7 +4663,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `gluster_volumes` service.
+    # Reference to the service that manages Gluster volumes for cluster.
     # 
     # @return [GlusterVolumesService] A reference to `gluster_volumes` service.
     # 
@@ -4395,7 +4681,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `networks` service.
+    # Reference to the service that manages assigned networks for cluster.
     # 
     # @return [AssignedNetworksService] A reference to `networks` service.
     # 
@@ -4404,7 +4690,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Reference to permissions.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -4498,6 +4784,37 @@ module OvirtSDK4
     # 
     # Provides the information about the capabilities of the specific cluster level managed by this service.
     # 
+    # For example, to find what CPU types are supported by level 3.6 you can send a request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusterlevels/3.6
+    # ----
+    # 
+    # That will return a <<types/cluster_level, ClusterLevel>> object containing the supported CPU types, and other
+    # information which describes the cluster level:
+    # 
+    # [source,xml]
+    # ----
+    # <cluster_level id="3.6">
+    #   <cpu_types>
+    #     <cpu_type>
+    #       <name>Intel Conroe Family</name>
+    #       <level>3</level>
+    #       <architecture>x86_64</architecture>
+    #     </cpu_type>
+    #     ...
+    #   </cpu_types>
+    #   <permits>
+    #     <permit id="1">
+    #       <name>create_vm</name>
+    #       <administrative>false</administrative>
+    #     </permit>
+    #     ...
+    #   </permits>
+    # </cluster_level>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @return [ClusterLevel]
@@ -4563,6 +4880,23 @@ module OvirtSDK4
     # 
     # Lists the cluster levels supported by the system.
     # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusterlevels
+    # ----
+    # 
+    # This will return a list of available cluster levels.
+    # 
+    # [source,xml]
+    # ----
+    # <cluster_levels>
+    #   <cluster_level id="4.0">
+    #      ...
+    #   </cluster_level>
+    #   ...
+    # </cluster_levels>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @return [Array<ClusterLevel>]
@@ -4751,7 +5085,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `cluster` service.
+    # Reference to the service that manages a specific cluster.
     # 
     # @param id [String] The identifier of the `cluster`.
     # 
@@ -5141,7 +5475,44 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get a data center.
+    # 
+    # An example of getting a data center:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/datacenters/123
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <data_center href="/ovirt-engine/api/datacenters/123" id="123">
+    #   <name>Default</name>
+    #   <description>The default Data Center</description>
+    #   <link href="/ovirt-engine/api/datacenters/123/clusters" rel="clusters"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/storagedomains" rel="storagedomains"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/permissions" rel="permissions"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/networks" rel="networks"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/quotas" rel="quotas"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/qoss" rel="qoss"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/iscsibonds" rel="iscsibonds"/>
+    #   <local>false</local>
+    #   <quota_mode>disabled</quota_mode>
+    #   <status>up</status>
+    #   <storage_format>v3</storage_format>
+    #   <supported_versions>
+    #     <version>
+    #       <major>4</major>
+    #       <minor>0</minor>
+    #    </version>
+    #   </supported_versions>
+    #   <version>
+    #     <major>4</major>
+    #     <minor>0</minor>
+    #   </version>
+    #   <mac_pool href="/ovirt-engine/api/macpools/456" id="456"/>
+    # </data_center>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -5284,7 +5655,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `iscsi_bonds` service.
+    # Reference to the iSCSI bonds service.
     # 
     # @return [IscsiBondsService] A reference to `iscsi_bonds` service.
     # 
@@ -5293,7 +5664,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `networks` service.
+    # Returns a reference to the service, that manages the networks, that are associated with the data center.
     # 
     # @return [NetworksService] A reference to `networks` service.
     # 
@@ -5302,7 +5673,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Reference to the permissions service.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -5311,7 +5682,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `qoss` service.
+    # Reference to the QOSs service.
     # 
     # @return [QossService] A reference to `qoss` service.
     # 
@@ -5320,7 +5691,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `quotas` service.
+    # Reference to the quotas service.
     # 
     # @return [QuotasService] A reference to `quotas` service.
     # 
@@ -5331,7 +5702,7 @@ module OvirtSDK4
     # 
     # Attach and detach storage domains to and from a data center.
     # 
-    # For attaching a single storage domain we should use the folowing POST request:
+    # For attaching a single storage domain we should use the following POST request:
     # 
     # [source]
     # ----
@@ -5347,7 +5718,7 @@ module OvirtSDK4
     # </storage_domain>
     # ----
     # 
-    # For detaching a single storage domain we should use the folowing DELETE request:
+    # For detaching a single storage domain we should use the following DELETE request:
     # 
     # [source]
     # ----
@@ -5607,7 +5978,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `data_center` service.
+    # Reference to the service that manages a specific data center.
     # 
     # @param id [String] The identifier of the `data_center`.
     # 
@@ -5665,6 +6036,24 @@ module OvirtSDK4
     # 
     # Returns the details of the attachment, including the bootable flag and link to the disk.
     # 
+    # An example of getting a disk attachment:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vms/123/diskattachments/456
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <disk_attachment href="/ovirt-engine/api/vms/123/diskattachments/456" id="456">
+    #   <active>true</active>
+    #   <bootable>true</bootable>
+    #   <interface>virtio</interface>
+    #   <disk href="/ovirt-engine/api/disks/456" id="456"/>
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    # </disk_attachment>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @return [DiskAttachment]
@@ -5687,9 +6076,18 @@ module OvirtSDK4
     end
     
     # 
-    # Removes the disk attachment. This will only detach the disk from the virtual machine, but won't remove it from
+    # Removes the disk attachment.
+    # 
+    # This will only detach the disk from the virtual machine, but won't remove it from
     # the system, unless the `detach_only` parameter is `false`.
     # 
+    # An example of removing a disk attachment:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vms/123/diskattachments/456?detach_only=true
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :detach_only Indicates if the disk should only be detached from the virtual machine, but not removed from the system.
@@ -5717,6 +6115,7 @@ module OvirtSDK4
     # <disk_attachment>
     #   <bootable>true</bootable>
     #   <interface>ide</interface>
+    #   <active>true</active>
     #   <disk>
     #     <name>mydisk</name>
     #     <provisioned_size>1024</provisioned_size>
@@ -5808,6 +6207,7 @@ module OvirtSDK4
     # <disk_attachment>
     #   <bootable>true</bootable>
     #   <interface>ide</interface>
+    #   <active>true</active>
     #   <disk id="123"/>
     # </disk_attachment>
     # ----
@@ -5819,6 +6219,7 @@ module OvirtSDK4
     # <disk_attachment>
     #   <bootable>true</bootable>
     #   <interface>ide</interface>
+    #   <active>true</active>
     #   <disk>
     #     <name>mydisk</name>
     #     <provisioned_size>1024</provisioned_size>
@@ -5836,6 +6237,11 @@ module OvirtSDK4
     # POST /ovirt-engine/api/vms/345/diskattachments
     # ----
     # 
+    # IMPORTANT: The server accepts requests that don't contain the `active` attribute, but the effect is
+    # undefined. In some cases the disk will be automatically activated and in other cases it won't. To
+    # avoid issues it is strongly recommended to always include the `active` attribute with the desired
+    # value.
+    # 
     # @param attachment [DiskAttachment] The `attachment` to add.
     # 
     # @param opts [Hash] Additional options.
@@ -6389,11 +6795,17 @@ module OvirtSDK4
     
     # 
     # Adds a new floating disk.
-    # When creating a new floating <<types/disk,Disk>>, the API requires the `storage_domain`, `provisioned_size` and
-    # `format` attributes.
     # 
-    # To create a new floating disk with specified `provisioned_size`, `format` and `name` on a storage domain with an
-    # id `e9fedf39-5edc-4e0a-8628-253f1b9c5693`, send a request as follows:
+    # There are three types of disks that can be added - disk image, direct LUN and
+    #  https://wiki.openstack.org/wiki/Cinder[Cinder] disk.
+    # 
+    # *Adding a new image disk:*
+    # 
+    # When creating a new floating image <<types/disk,Disk>>, the API requires the `storage_domain`, `provisioned_size`
+    # and `format` attributes.
+    # 
+    # To create a new floating image disk with specified `provisioned_size`, `format` and `name` on a storage domain
+    # with an id `123`, send a request as follows:
     # 
     # [source]
     # ----
@@ -6406,15 +6818,85 @@ module OvirtSDK4
     # ----
     # <disk>
     #   <storage_domains>
-    #     <storage_domain id="e9fedf39-5edc-4e0a-8628-253f1b9c5693"/>
+    #     <storage_domain id="123"/>
     #   </storage_domains>
-    #   <name>disk1</name>
+    #   <name>mydisk</name>
     #   <provisioned_size>1048576</provisioned_size>
     #   <format>cow</format>
     # </disk>
     # ----
     # 
-    # @param disk [Disk] The `disk` to add.
+    # 
+    # *Adding a new direct LUN disk:*
+    # 
+    # When adding a new floating direct LUN via the API, there are two flavors that can be used:
+    # 
+    # . With a `host` element - in this case, the host is used for sanity checks (e.g., that the LUN is visible) and
+    # to retrieve basic information about the LUN (e.g., size and serial).
+    # . Without a `host` element - in this case, the operation is a database-only operation, and the storage is never
+    # accessed.
+    # 
+    # To create a new floating direct LUN disk with a `host` element with an id `123`, specified `alias`, `type` and
+    # `logical_unit` with an id `456` (that has the attributes `address`, `port` and `target`),
+    # send a request as follows:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/disks
+    # ----
+    # 
+    # With a request body as follows:
+    # 
+    # [source,xml]
+    # ----
+    # <disk>
+    #   <alias>mylun</alias>
+    #   <lun_storage>
+    #     <host id="123"/>
+    #     <type>iscsi</type>
+    #     <logical_units>
+    #       <logical_unit id="456">
+    #         <address>10.35.10.20</address>
+    #         <port>3260</port>
+    #         <target>iqn.2017-01.com.myhost:444</target>
+    #       </logical_unit>
+    #     </logical_units>
+    #   </lun_storage>
+    # </disk>
+    # ----
+    # 
+    # To create a new floating direct LUN disk without using a host, remove the `host` element.
+    # 
+    # 
+    # *Adding a new Cinder disk:*
+    # 
+    # To create a new floating Cinder disk, send a request as follows:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/disks
+    # ----
+    # 
+    # With a request body as follows:
+    # 
+    # [source,xml]
+    # ----
+    # <disk>
+    #   <openstack_volume_type>
+    #     <name>myceph</name>
+    #   </openstack_volume_type>
+    #   <storage_domains>
+    #     <storage_domain>
+    #       <name>cinderDomain</name>
+    #     </storage_domain>
+    #   </storage_domains>
+    #   <provisioned_size>1073741824</provisioned_size>
+    #   <interface>virtio</interface>
+    #   <format>raw</format>
+    # </disk>
+    # ----
+    # 
+    # @param disk [Disk] The disk.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6448,7 +6930,37 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get list of disks.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/disks
+    # ----
+    # 
+    # You will get a XML response which will look like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <disks>
+    #   <disk id="123">
+    #     <actions>...</actions>
+    #     <name>MyDisk</name>
+    #     <description>MyDisk description</description>
+    #     <link href="/ovirt-engine/api/disks/123/permissions" rel="permissions"/>
+    #     <link href="/ovirt-engine/api/disks/123/statistics" rel="statistics"/>
+    #     <actual_size>5345845248</actual_size>
+    #     <alias>MyDisk alias</alias>
+    #     ...
+    #     <status>ok</status>
+    #     <storage_type>image</storage_type>
+    #     <wipe_after_delete>false</wipe_after_delete>
+    #     <disk_profile id="123"/>
+    #     <quota id="123"/>
+    #     <storage_domains>...</storage_domains>
+    #   </disk>
+    #   ...
+    # </disks>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6494,7 +7006,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `disk` service.
+    # Reference to a service managing a specific disk.
     # 
     # @param id [String] The identifier of the `disk`.
     # 
@@ -6550,7 +7062,26 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the authentication domain information.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/domains/5678
+    # ....
+    # 
+    # Will return the domain information:
+    # 
+    # [source,xml]
+    # ----
+    # <domain href="/ovirt-engine/api/domains/5678" id="5678">
+    #   <name>internal-authz</name>
+    #   <link href="/ovirt-engine/api/domains/5678/users" rel="users"/>
+    #   <link href="/ovirt-engine/api/domains/5678/groups" rel="groups"/>
+    #   <link href="/ovirt-engine/api/domains/5678/users?search={query}" rel="users/search"/>
+    #   <link href="/ovirt-engine/api/domains/5678/groups?search={query}" rel="groups/search"/>
+    # </domain>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6574,7 +7105,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `groups` service.
+    # Reference to a service to manage domain groups.
     # 
     # @return [DomainGroupsService] A reference to `groups` service.
     # 
@@ -6583,7 +7114,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `users` service.
+    # Reference to a service to manage domain users.
     # 
     # @return [DomainUsersService] A reference to `users` service.
     # 
@@ -6812,7 +7343,29 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the domain user information.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/domains/5678/users/1234
+    # ....
+    # 
+    # Will return the domain user information:
+    # 
+    # [source,xml]
+    # ----
+    # <user href="/ovirt-engine/api/users/1234" id="1234">
+    #   <name>admin</name>
+    #   <namespace>*</namespace>
+    #   <principal>admin</principal>
+    #   <user_name>admin@internal-authz</user_name>
+    #   <domain href="/ovirt-engine/api/domains/5678" id="5678">
+    #     <name>internal-authz</name>
+    #   </domain>
+    #   <groups/>
+    # </user>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6877,7 +7430,31 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all the users in the domain.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/domains/5678/users
+    # ....
+    # 
+    # Will return the list of users in the domain:
+    # 
+    # [source,xml]
+    # ----
+    # <users>
+    #   <user href="/ovirt-engine/api/domains/5678/users/1234" id="1234">
+    #     <name>admin</name>
+    #     <namespace>*</namespace>
+    #     <principal>admin</principal>
+    #     <user_name>admin@internal-authz</user_name>
+    #     <domain href="/ovirt-engine/api/domains/5678" id="5678">
+    #       <name>internal-authz</name>
+    #     </domain>
+    #     <groups/>
+    #   </user>
+    # </users>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6923,7 +7500,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `user` service.
+    # Reference to a service to view details of a domain user.
     # 
     # @param id [String] The identifier of the `user`.
     # 
@@ -6979,7 +7556,28 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all the authentication domains in the system.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/domains
+    # ....
+    # 
+    # Will return the list of domains:
+    # 
+    # [source,xml]
+    # ----
+    # <domains>
+    #   <domain href="/ovirt-engine/api/domains/5678" id="5678">
+    #     <name>internal-authz</name>
+    #     <link href="/ovirt-engine/api/domains/5678/users" rel="users"/>
+    #     <link href="/ovirt-engine/api/domains/5678/groups" rel="groups"/>
+    #     <link href="/ovirt-engine/api/domains/5678/users?search={query}" rel="users/search"/>
+    #     <link href="/ovirt-engine/api/domains/5678/groups?search={query}" rel="groups/search"/>
+    #   </domain>
+    # </domains>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7010,7 +7608,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `domain` service.
+    # Reference to a service to view details of a domain.
     # 
     # @param id [String] The identifier of the `domain`.
     # 
@@ -7066,7 +7664,35 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get an event.
+    # 
+    # An example of getting an event:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/events/123
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <event href="/ovirt-engine/api/events/123" id="123">
+    #   <description>Host example.com was added by admin@internal-authz.</description>
+    #   <code>42</code>
+    #   <correlation_id>135</correlation_id>
+    #   <custom_id>-1</custom_id>
+    #   <flood_rate>30</flood_rate>
+    #   <origin>oVirt</origin>
+    #   <severity>normal</severity>
+    #   <time>2016-12-11T11:13:44.654+02:00</time>
+    #   <cluster href="/ovirt-engine/api/clusters/456" id="456"/>
+    #   <host href="/ovirt-engine/api/hosts/789" id="789"/>
+    #   <user href="/ovirt-engine/api/users/987" id="987"/>
+    # </event>
+    # ----
+    # 
+    # Note that the number of fields changes according to the information that resides on the event.
+    # For example, for storage domain related events you will get the storage domain reference,
+    # as well as the reference for the data center this storage domain resides in.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -7235,7 +7861,7 @@ module OvirtSDK4
     # GET /ovirt-engine/api/events
     # ----
     # 
-    # To the above request we get following reponse:
+    # To the above request we get following response:
     # 
     # [source,xml]
     # ----
@@ -7420,7 +8046,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `event` service.
+    # Reference to the service that manages a specific event.
     # 
     # @param id [String] The identifier of the `event`.
     # 
@@ -9213,13 +9839,37 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `activate` method.
+    # Activate the bricks post data migration of remove brick operation.
+    # 
+    # Used to activate brick(s) once the data migration from bricks is complete but user no longer wishes to remove
+    # bricks. The bricks that were previously marked for removal will now be used as normal bricks.
+    # 
+    # For example, to retain the bricks that on glustervolume `123` from which data was migrated, send a request like
+    # this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/activate
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <bricks>
+    #     <brick>
+    #       <name>host1:/rhgs/brick1</name>
+    #     </brick>
+    #   </bricks>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the activation should be performed asynchronously.
     # 
-    # @option opts [Array<GlusterBrick>] :bricks 
+    # @option opts [Array<GlusterBrick>] :bricks The list of bricks that need to be re-activated.
     # 
     def activate(opts = {})
       action = Action.new(opts)
@@ -9242,13 +9892,39 @@ module OvirtSDK4
     end
     
     # 
-    # Adds given list of bricks to the volume, and updates the database accordingly. The properties `serverId` and
-    # `brickDir`are required.
+    # Adds a list of bricks to gluster volume.
+    # 
+    # Used to expand a gluster volume by adding bricks. For replicated volume types, the parameter `replica_count`
+    # needs to be passed. In case the replica count is being increased, then the number of bricks needs to be
+    # equivalent to the number of replica sets.
+    # 
+    # For example, to add bricks to gluster volume `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <bricks>
+    #   <brick>
+    #     <server_id>111</server_id>
+    #     <brick_dir>/export/data/brick3</brick_dir>
+    #   </brick>
+    # </bricks>
+    # ----
     # 
     # @param bricks [Array<GlusterBrick>] The list of bricks to be added to the volume
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Integer] :replica_count Replica count of volume post add operation.
+    # 
+    # @option opts [Integer] :stripe_count Stripe count of volume post add operation.
+    # 
     # @return [Array<GlusterBrick>]
     # 
     def add(bricks, opts = {})
@@ -9261,6 +9937,16 @@ module OvirtSDK4
         end
       end
       query = {}
+      value = opts[:replica_count]
+      unless value.nil?
+        value = Writer.render_integer(value)
+        query['replica_count'] = value
+      end
+      value = opts[:stripe_count]
+      unless value.nil?
+        value = Writer.render_integer(value)
+        query['stripe_count'] = value
+      end
       request = HttpRequest.new(method: :POST, url: @path, query: query)
       begin
         writer = XmlWriter.new(nil, true)
@@ -9284,7 +9970,34 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists the bricks of a gluster volume.
+    # 
+    # For example, to list bricks of gluster volume `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
+    # ----
+    # 
+    # Provides an output as below:
+    # 
+    # [source,xml]
+    # ----
+    # <bricks>
+    #   <brick id="234">
+    #     <name>host1:/rhgs/data/brick1</name>
+    #     <brick_dir>/rhgs/data/brick1</brick_dir>
+    #     <server_id>111</server_id>
+    #     <status>up</status>
+    #   </brick>
+    #   <brick id="233">
+    #     <name>host2:/rhgs/data/brick1</name>
+    #     <brick_dir>/rhgs/data/brick1</brick_dir>
+    #     <server_id>222</server_id>
+    #     <status>up</status>
+    #   </brick>
+    # </bricks>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9315,13 +10028,41 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `migrate` method.
+    # Start migration of data prior to removing bricks.
+    # 
+    # Removing bricks is a two-step process, where the data on bricks to be removed, is first migrated to remaining
+    # bricks. Once migration is completed the removal of bricks is confirmed via the API
+    # <<services/gluster_bricks/methods/remove, remove>>. If at any point, the action needs to be cancelled
+    # <<services/gluster_bricks/methods/stop_migrate, stopmigrate>> has to be called.
+    # 
+    # For instance, to delete a brick from a gluster volume with id `123`, send a request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/migrate
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <bricks>
+    #     <brick>
+    #       <name>host1:/rhgs/brick1</name>
+    #     </brick>
+    #   </bricks>
+    # </action>
+    # ----
+    # 
+    # The migration process can be tracked from the job id returned from the API using
+    # <<services/job/methods/get, job>> and steps in job using <<services/step/methods/get, step>>
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the migration should be performed asynchronously.
     # 
-    # @option opts [Array<GlusterBrick>] :bricks 
+    # @option opts [Array<GlusterBrick>] :bricks List of bricks for which data migration needs to be started.
     # 
     def migrate(opts = {})
       action = Action.new(opts)
@@ -9344,12 +10085,35 @@ module OvirtSDK4
     end
     
     # 
-    # Removes the given list of bricks brick from the volume and deletes them from the database.
+    # Removes bricks from gluster volume.
+    # 
+    # The recommended way to remove bricks without data loss is to first migrate the data using
+    # <<services/gluster_bricks/methods/stop_migrate, stopmigrate>> and then removing them. If migrate was not called on
+    # bricks prior to remove, the bricks are removed without data migration which may lead to data loss.
+    # 
+    # For example, to delete the bricks from gluster volume `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <bricks>
+    #   <brick>
+    #     <name>host:brick_directory</name>
+    #   </brick>
+    # </bricks>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
     # @option opts [Array<GlusterBrick>] :bricks The list of bricks to be removed
+    # @option opts [Integer] :replica_count Replica count of volume post add operation.
     def remove(opts = {})
       query = {}
       value = opts[:async]
@@ -9361,6 +10125,11 @@ module OvirtSDK4
       unless value.nil?
         query['bricks'] = value
       end
+      value = opts[:replica_count]
+      unless value.nil?
+        value = Writer.render_integer(value)
+        query['replica_count'] = value
+      end
       request = HttpRequest.new(method: :DELETE, url: @path, query: query)
       response = @connection.send(request)
       unless response.code == 200
@@ -9369,13 +10138,36 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `stop_migrate` method.
+    # Stops migration of data from bricks for a remove brick operation.
+    # 
+    # To cancel data migration that was started as part of the 2-step remove brick process in case the user wishes to
+    # continue using the bricks. The bricks that were marked for removal will function as normal bricks post this
+    # operation.
+    # 
+    # For example, to stop migration of data from the bricks of gluster volume `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/stopmigrate
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <bricks>
+    #   <brick>
+    #     <name>host:brick_directory</name>
+    #   </brick>
+    # </bricks>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
-    # @option opts [Array<GlusterBrick>] :bricks 
+    # @option opts [Array<GlusterBrick>] :bricks List of bricks for which data migration needs to be stopped. This list should match the arguments passed to
+    #   <<services/gluster_bricks/methods/migrate, migrate>>.
     # 
     def stop_migrate(opts = {})
       action = Action.new(opts)
@@ -9398,7 +10190,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `brick` service.
+    # Returns a reference to the service managing a single gluster brick.
     # 
     # @param id [String] The identifier of the `brick`.
     # 
@@ -9721,10 +10513,44 @@ module OvirtSDK4
     end
     
     # 
-    # Creates a new Gluster volume and adds it to the database. The volume is created based on properties of the
-    # `volume` parameter. The properties `name`, `volumeType` and `bricks` are required.
+    # Creates a new gluster volume.
+    # 
+    # The volume is created based on properties of the `volume` parameter. The properties `name`, `volume_type` and
+    # `bricks` are required.
+    # 
+    # For example, to add a volume with name `myvolume` to the cluster `123`, send the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/123/glustervolumes
+    # ----
+    # 
+    # With the following request body:
     # 
-    # @param volume [GlusterVolume] The Gluster volume definition from which to create the volume is passed as input and the newly created
+    # [source,xml]
+    # ----
+    # <gluster_volume>
+    #   <name>myvolume</name>
+    #   <volume_type>replicate</volume_type>
+    #   <replica_count>3</replica_count>
+    #   <bricks>
+    #     <brick>
+    #       <server_id>server1</server_id>
+    #       <brick_dir>/exp1</brick_dir>
+    #     </brick>
+    #     <brick>
+    #       <server_id>server2</server_id>
+    #       <brick_dir>/exp1</brick_dir>
+    #     </brick>
+    #     <brick>
+    #       <server_id>server3</server_id>
+    #       <brick_dir>/exp1</brick_dir>
+    #     </brick>
+    #   <bricks>
+    # </gluster_volume>
+    # ----
+    # 
+    # @param volume [GlusterVolume] The gluster volume definition from which to create the volume is passed as input and the newly created
     #   volume is returned.
     # 
     # @param opts [Hash] Additional options.
@@ -9759,7 +10585,15 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists all gluster volumes in the cluster.
+    # 
+    # For example, to list all Gluster Volumes in cluster `456`, send a request like
+    # this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusters/456/glustervolumes
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -9805,7 +10639,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `volume` service.
+    # Reference to a service managing gluster volume.
     # 
     # @param id [String] The identifier of the `volume`.
     # 
@@ -10004,7 +10838,7 @@ module OvirtSDK4
     #   
     #   [source]
     #   ----
-    #   GET /ovit-engine/api/vms/{vm:id}/graphicsconsoles?current=true
+    #   GET /ovirt-engine/api/vms/123/graphicsconsoles?current=true
     #   ----
     #   
     #   The default value is `false`.
@@ -10385,7 +11219,26 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieve information about a particular host's device.
+    # 
+    # An example of getting a host device:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/hosts/123/devices/456
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <host_device href="/ovirt-engine/api/hosts/123/devices/456" id="456">
+    #   <name>usb_1_9_1_1_0</name>
+    #   <capability>usb</capability>
+    #   <host href="/ovirt-engine/api/hosts/123" id="123"/>
+    #   <parent_device href="/ovirt-engine/api/hosts/123/devices/789" id="789">
+    #     <name>usb_1_9_1</name>
+    #   </parent_device>
+    # </host_device>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -10450,7 +11303,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List the devices of a host.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -10481,7 +11334,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `device` service.
+    # Reference to the service that can be used to access a specific host device.
     # 
     # @param id [String] The identifier of the `device`.
     # 
@@ -10720,7 +11573,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `nic` service.
+    # Reference to the service that manages a single network interface.
     # 
     # @param id [String] The identifier of the `nic`.
     # 
@@ -10863,7 +11716,24 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get list of storages.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/hosts/123/storage
+    # ----
+    # 
+    # The XML response you get will be like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <host_storages>
+    #   <host_storage id="123">
+    #     ...
+    #   </host_storage>
+    #   ...
+    # </host_storages>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -10878,21 +11748,21 @@ module OvirtSDK4
     #   
     #   [source,xml]
     #   ----
-    #   <host_storage id="360014051136c20574f743bdbd28177fd">
+    #   <host_storage id="123">
     #     <logical_units>
-    #       <logical_unit id="360014051136c20574f743bdbd28177fd">
+    #       <logical_unit id="123">
     #         <lun_mapping>0</lun_mapping>
     #         <paths>1</paths>
     #         <product_id>lun0</product_id>
-    #         <serial>SLIO-ORG_lun0_1136c205-74f7-43bd-bd28-177fd5ce6993</serial>
+    #         <serial>123</serial>
     #         <size>10737418240</size>
     #         <status>used</status>
     #         <vendor_id>LIO-ORG</vendor_id>
-    #         <volume_group_id>O9Du7I-RahN-ECe1-dZ1w-nh0b-64io-MNzIBZ</volume_group_id>
+    #         <volume_group_id>123</volume_group_id>
     #       </logical_unit>
     #     </logical_units>
     #     <type>iscsi</type>
-    #     <host id="8bb5ade5-e988-4000-8b93-dbfc6717fe50"/>
+    #     <host id="123"/>
     #   </host_storage>
     #   ----
     #   
@@ -10900,20 +11770,20 @@ module OvirtSDK4
     #   
     #   [source,xml]
     #   ----
-    #   <host_storage id="360014051136c20574f743bdbd28177fd">
+    #   <host_storage id="123">
     #     <logical_units>
-    #       <logical_unit id="360014051136c20574f743bdbd28177fd">
+    #       <logical_unit id="123">
     #         <lun_mapping>0</lun_mapping>
     #         <paths>1</paths>
     #         <product_id>lun0</product_id>
-    #         <serial>SLIO-ORG_lun0_1136c205-74f7-43bd-bd28-177fd5ce6993</serial>
+    #         <serial>123</serial>
     #         <size>10737418240</size>
     #         <vendor_id>LIO-ORG</vendor_id>
-    #         <volume_group_id>O9Du7I-RahN-ECe1-dZ1w-nh0b-64io-MNzIBZ</volume_group_id>
+    #         <volume_group_id>123</volume_group_id>
     #       </logical_unit>
     #     </logical_units>
     #     <type>iscsi</type>
-    #     <host id="8bb5ade5-e988-4000-8b93-dbfc6717fe50"/>
+    #     <host id="123"/>
     #   </host_storage>
     #   ----
     # 
@@ -10942,7 +11812,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `storage` service.
+    # Reference to a service managing the storage.
     # 
     # @param id [String] The identifier of the `storage`.
     # 
@@ -11084,7 +11954,28 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get a list of all available hosts.
+    # 
+    # For example, to list the hosts send the following request:
+    # 
+    # ....
+    # GET /ovirt-engine/api/hosts
+    # ....
+    # 
+    # The response body will be something like this:
+    # 
+    # [source,xml]
+    # ----
+    # <hosts>
+    #   <host href="/ovirt-engine/api/hosts/123" id="123">
+    #     ...
+    #   </host>
+    #   <host href="/ovirt-engine/api/hosts/456" id="456">
+    #     ...
+    #   </host>
+    #   ...
+    # </host>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11137,7 +12028,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `host` service.
+    # A Reference to service managing a specific host.
     # 
     # @param id [String] The identifier of the `host`.
     # 
@@ -11193,7 +12084,22 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get an icon.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/icons/123
+    # ----
+    # 
+    # You will get a XML response like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <icon id="123">
+    #   <data>Some binary data here</data>
+    #   <media_type>image/png</media_type>
+    # </icon>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11258,7 +12164,25 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get a list of icons.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/icons
+    # ----
+    # 
+    # You will get a XML response which is similar to this one:
+    # 
+    # [source,xml]
+    # ----
+    # <icons>
+    #   <icon id="123">
+    #     <data>...</data>
+    #     <media_type>image/png</media_type>
+    #   </icon>
+    #   ...
+    # </icons>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11289,7 +12213,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `icon` service.
+    # Reference to the service that manages an specific icon.
     # 
     # @param id [String] The identifier of the `icon`.
     # 
@@ -11837,7 +12761,12 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get a specific instance type and it's attributes.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/instancetypes/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11861,7 +12790,15 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a specific instance type from the system.
+    # 
+    # If a virtual machine was created using an instance type X after removal of the instance type
+    # the virtual machine's instance type will be set to `custom`.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/instancetypes/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -11881,7 +12818,35 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `instance_type`.
+    # Update a specific instance type and it's attributes.
+    # 
+    # All the attributes are editable after creation.
+    # If a virtual machine was created using an instance type X and some configuration in instance
+    # type X was updated, the virtual machine's configuration will be updated automatically by the
+    # engine.
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/instancetypes/123
+    # ----
+    # 
+    # For example, to update the memory of instance type `123` to 1 GiB and set the cpu topology
+    # to 2 sockets and 1 core, send a request like this:
+    # 
+    # [source, xml]
+    # ----
+    # 
+    # <instance_type>
+    #   <memory>1073741824</memory>
+    #   <cpu>
+    #     <topology>
+    #       <cores>1</cores>
+    #       <sockets>2</sockets>
+    #       <threads>1</threads>
+    #     </topology>
+    #   </cpu>
+    # </instance_type>
+    # ----
     # 
     # @param instance_type [InstanceType] The `instance_type` to update.
     # @param opts [Hash] Additional options.
@@ -11924,7 +12889,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `graphics_consoles` service.
+    # Reference to the service that manages the graphic consoles that are attached to this
+    # instance type.
     # 
     # @return [GraphicsConsolesService] A reference to `graphics_consoles` service.
     # 
@@ -11933,7 +12899,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `nics` service.
+    # Reference to the service that manages the NICs that are attached to this instance type.
     # 
     # @return [InstanceTypeNicsService] A reference to `nics` service.
     # 
@@ -11942,7 +12908,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `watchdogs` service.
+    # Reference to the service that manages the watchdogs that are attached to this instance type.
     # 
     # @return [InstanceTypeWatchdogsService] A reference to `watchdogs` service.
     # 
@@ -12010,7 +12976,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets network interface configuration of the instance type.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12034,7 +13000,7 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove the network interface from the instance type.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12054,7 +13020,7 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `nic`.
+    # Updates the network interface configuration of the instance type.
     # 
     # @param nic [Nic] The `nic` to update.
     # @param opts [Hash] Additional options.
@@ -12138,7 +13104,7 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `nic`.
+    # Add new network interface to the instance type.
     # 
     # @param nic [Nic] The `nic` to add.
     # 
@@ -12174,12 +13140,14 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists all the configured network interface of the instance type.
     # 
     # @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.
     # 
+    # @option opts [String] :search A query string used to restrict the returned templates.
+    # 
     # @return [Array<Nic>]
     # 
     def list(opts = {})
@@ -12189,6 +13157,10 @@ module OvirtSDK4
         value = Writer.render_integer(value)
         query['max'] = value
       end
+      value = opts[:search]
+      unless value.nil?
+        query['search'] = value
+      end
       request = HttpRequest.new(method: :GET, url: @path, query: query)
       response = @connection.send(request)
       case response.code
@@ -12261,7 +13233,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets watchdog configuration of the instance type.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12285,7 +13257,7 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove a watchdog from the instance type.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12305,7 +13277,7 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `watchdog`.
+    # Updates the watchdog configuration of the instance type.
     # 
     # @param watchdog [Watchdog] The `watchdog` to update.
     # @param opts [Hash] Additional options.
@@ -12389,7 +13361,7 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `watchdog`.
+    # Add new watchdog to the instance type.
     # 
     # @param watchdog [Watchdog] The `watchdog` to add.
     # 
@@ -12425,11 +13397,14 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists all the configured watchdogs of the instance type.
     # 
     # @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.
+    # @option opts [Integer] :max Sets the maximum number of watchdogs to return. If not specified all the watchdogs are
+    #   returned.
+    # 
+    # @option opts [String] :search A query string used to restrict the returned templates.
     # 
     # @return [Array<Watchdog>]
     # 
@@ -12440,6 +13415,10 @@ module OvirtSDK4
         value = Writer.render_integer(value)
         query['max'] = value
       end
+      value = opts[:search]
+      unless value.nil?
+        query['search'] = value
+      end
       request = HttpRequest.new(method: :GET, url: @path, query: query)
       response = @connection.send(request)
       case response.code
@@ -12512,7 +13491,91 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `instance_type`.
+    # Creates a new instance type.
+    # 
+    # This requires only a name attribute and can include all hardware configurations of the
+    # virtual machine.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/instancetypes
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <instance_type>
+    #   <name>myinstancetype</name>
+    # </template>
+    # ----
+    # 
+    # Creating an instance type with all hardware configurations with a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <instance_type>
+    #   <name>myinstancetype</name>
+    #   <console>
+    #     <enabled>true</enabled>
+    #   </console>
+    #   <cpu>
+    #     <topology>
+    #       <cores>2</cores>
+    #       <sockets>2</sockets>
+    #       <threads>1</threads>
+    #     </topology>
+    #   </cpu>
+    #   <custom_cpu_model>AMD Opteron_G2</custom_cpu_model>
+    #   <custom_emulated_machine>q35</custom_emulated_machine>
+    #   <display>
+    #     <monitors>1</monitors>
+    #     <single_qxl_pci>true</single_qxl_pci>
+    #     <smartcard_enabled>true</smartcard_enabled>
+    #     <type>spice</type>
+    #   </display>
+    #   <high_availability>
+    #     <enabled>true</enabled>
+    #     <priority>1</priority>
+    #   </high_availability>
+    #   <io>
+    #     <threads>2</threads>
+    #   </io>
+    #   <memory>4294967296</memory>
+    #   <memory_policy>
+    #     <ballooning>true</ballooning>
+    #     <guaranteed>268435456</guaranteed>
+    #   </memory_policy>
+    #   <migration>
+    #     <auto_converge>inherit</auto_converge>
+    #     <compressed>inherit</compressed>
+    #     <policy id="00000000-0000-0000-0000-000000000000"/>
+    #   </migration>
+    #   <migration_downtime>2</migration_downtime>
+    #   <os>
+    #     <boot>
+    #       <devices>
+    #         <device>hd</device>
+    #       </devices>
+    #     </boot>
+    #   </os>
+    #   <rng_device>
+    #     <rate>
+    #       <bytes>200</bytes>
+    #       <period>2</period>
+    #     </rate>
+    #     <source>urandom</source>
+    #   </rng_device>
+    #   <soundcard_enabled>true</soundcard_enabled>
+    #   <usb>
+    #     <enabled>true</enabled>
+    #     <type>native</type>
+    #   </usb>
+    #   <virtio_scsi>
+    #     <enabled>true</enabled>
+    #   </virtio_scsi>
+    # </instance_type>
+    # ----
     # 
     # @param instance_type [InstanceType] The `instance_type` to add.
     # 
@@ -12548,21 +13611,37 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists all existing instance types in the system.
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Integer] :max Sets the maximum number of instance types to return. If not specified all the instance types are returned.
+    # @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] :max Sets the maximum number of instance types to return. If not specified all the instance
+    #   types are returned.
+    # 
+    # @option opts [String] :search A query string used to restrict the returned templates.
     # 
     # @return [Array<InstanceType>]
     # 
     def list(opts = {})
       query = {}
+      value = opts[:case_sensitive]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['case_sensitive'] = value
+      end
       value = opts[:max]
       unless value.nil?
         value = Writer.render_integer(value)
         query['max'] = value
       end
+      value = opts[:search]
+      unless value.nil?
+        query['search'] = value
+      end
       request = HttpRequest.new(method: :GET, url: @path, query: query)
       response = @connection.send(request)
       case response.code
@@ -12659,7 +13738,7 @@ module OvirtSDK4
     end
     
     # 
-    # Removes of an exisitng iSCSI bond.
+    # Removes of an existing iSCSI bond.
     # 
     # For example, to remove the iSCSI bond `456` send a request like this:
     # 
@@ -12965,7 +14044,21 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `clear` method.
+    # Set an external job execution to be cleared by the system.
+    # 
+    # For example, to set a job with identifier `123` send the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/jobs/clear
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12992,13 +14085,30 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `end_` method.
+    # Marks an external job execution as ended.
+    # 
+    # For example, to terminate a job with identifier `123` send the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/jobs/end
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <force>true</force>
+    #   <status>finished</status>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
-    # @option opts [Boolean] :force 
+    # @option opts [Boolean] :force Indicates if the job should be forcibly terminated.
     # 
     def end_(opts = {})
       action = Action.new(opts)
@@ -13021,7 +14131,33 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves a job.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/jobs/123
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <job href="/ovirt-engine/api/jobs/123" id="123">
+    #   <actions>
+    #     <link href="/ovirt-engine/api/jobs/123/clear" rel="clear"/>
+    #     <link href="/ovirt-engine/api/jobs/123/end" rel="end"/>
+    #   </actions>
+    #   <description>Adding Disk</description>
+    #   <link href="/ovirt-engine/api/jobs/123/steps" rel="steps"/>
+    #   <auto_cleared>true</auto_cleared>
+    #   <end_time>2016-12-12T23:07:29.758+02:00</end_time>
+    #   <external>false</external>
+    #   <last_updated>2016-12-12T23:07:29.758+02:00</last_updated>
+    #   <start_time>2016-12-12T23:07:26.593+02:00</start_time>
+    #   <status>failed</status>
+    #   <owner href="/ovirt-engine/api/users/456" id="456"/>
+    # </job>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13045,7 +14181,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `steps` service.
+    # List all the steps of the job.
     # 
     # @return [StepsService] A reference to `steps` service.
     # 
@@ -13101,9 +14237,46 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `job`.
+    # Add an external job.
+    # 
+    # For example, to add a job with the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/jobs
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <job>
+    #   <description>Doing some work</description>
+    #   <auto_cleared>true</auto_cleared>
+    # </job>
+    # ----
+    # 
+    # The response should look like:
+    # 
+    # [source,xml]
+    # ----
+    # <job href="/ovirt-engine/api/jobs/123" id="123">
+    #   <actions>
+    #     <link href="/ovirt-engine/api/jobs/123/clear" rel="clear"/>
+    #     <link href="/ovirt-engine/api/jobs/123/end" rel="end"/>
+    #   </actions>
+    #   <description>Doing some work</description>
+    #   <link href="/ovirt-engine/api/jobs/123/steps" rel="steps"/>
+    #   <auto_cleared>true</auto_cleared>
+    #   <external>true</external>
+    #   <last_updated>2016-12-13T02:15:42.130+02:00</last_updated>
+    #   <start_time>2016-12-13T02:15:42.130+02:00</start_time>
+    #   <status>started</status>
+    #   <owner href="/ovirt-engine/api/users/456" id="456"/>
+    # </job>
+    # ----
     # 
-    # @param job [Job] The `job` to add.
+    # @param job [Job] Job that will be added.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13137,7 +14310,36 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves the representation of the jobs.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/jobs
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <jobs>
+    #   <job href="/ovirt-engine/api/jobs/123" id="123">
+    #     <actions>
+    #       <link href="/ovirt-engine/api/jobs/123/clear" rel="clear"/>
+    #       <link href="/ovirt-engine/api/jobs/123/end" rel="end"/>
+    #     </actions>
+    #     <description>Adding Disk</description>
+    #     <link href="/ovirt-engine/api/jobs/123/steps" rel="steps"/>
+    #     <auto_cleared>true</auto_cleared>
+    #     <end_time>2016-12-12T23:07:29.758+02:00</end_time>
+    #     <external>false</external>
+    #     <last_updated>2016-12-12T23:07:29.758+02:00</last_updated>
+    #     <start_time>2016-12-12T23:07:26.593+02:00</start_time>
+    #     <status>failed</status>
+    #     <owner href="/ovirt-engine/api/users/456" id="456"/>
+    #   </job>
+    #   ...
+    # </jobs>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13168,7 +14370,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `job` service.
+    # Reference to the job service.
     # 
     # @param id [String] The identifier of the `job`.
     # 
@@ -13224,7 +14426,36 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves the representation of the Katello errata.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/katelloerrata
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <katello_errata>
+    #   <katello_erratum href="/ovirt-engine/api/katelloerrata/123" id="123">
+    #     <name>RHBA-2013:XYZ</name>
+    #     <description>The description of the erratum</description>
+    #     <title>some bug fix update</title>
+    #     <type>bugfix</type>
+    #     <issued>2013-11-20T02:00:00.000+02:00</issued>
+    #     <solution>Few guidelines regarding the solution</solution>
+    #     <summary>Updated packages that fix one bug are now available for XYZ</summary>
+    #     <packages>
+    #       <package>
+    #         <name>libipa_hbac-1.9.2-82.11.el6_4.i686</name>
+    #       </package>
+    #       ...
+    #     </packages>
+    #   </katello_erratum>
+    #   ...
+    # </katello_errata>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13255,7 +14486,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `katello_erratum` service.
+    # Reference to the Katello erratum service.
+    # Use this service to view the erratum by its id.
     # 
     # @param id [String] The identifier of the `katello_erratum`.
     # 
@@ -13311,7 +14543,33 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves a Katello erratum.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/katelloerrata/123
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <katello_erratum href="/ovirt-engine/api/katelloerrata/123" id="123">
+    #   <name>RHBA-2013:XYZ</name>
+    #   <description>The description of the erratum</description>
+    #   <title>some bug fix update</title>
+    #   <type>bugfix</type>
+    #   <issued>2013-11-20T02:00:00.000+02:00</issued>
+    #   <solution>Few guidelines regarding the solution</solution>
+    #   <summary>Updated packages that fix one bug are now available for XYZ</summary>
+    #   <packages>
+    #     <package>
+    #       <name>libipa_hbac-1.9.2-82.11.el6_4.i686</name>
+    #     </package>
+    #     ...
+    #   </packages>
+    # </katello_erratum>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13815,7 +15073,33 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets a logical network.
+    # 
+    # For example:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/networks/123
+    # ----
+    # 
+    # Will respond:
+    # 
+    # [source,xml]
+    # ----
+    # <network href="/ovirt-engine/api/networks/123" id="123">
+    #   <name>ovirtmgmt</name>
+    #   <description>Default Management Network</description>
+    #   <link href="/ovirt-engine/api/networks/123/permissions" rel="permissions"/>
+    #   <link href="/ovirt-engine/api/networks/123/vnicprofiles" rel="vnicprofiles"/>
+    #   <link href="/ovirt-engine/api/networks/123/networklabels" rel="networklabels"/>
+    #   <mtu>0</mtu>
+    #   <stp>false</stp>
+    #   <usages>
+    #     <usage>vm</usage>
+    #   </usages>
+    #   <data_center href="/ovirt-engine/api/datacenters/456" id="456"/>
+    # </network>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13839,7 +15123,7 @@ module OvirtSDK4
     end
     
     # 
-    # Removes a logical network.
+    # Removes a logical network, or the association of a logical network to a data center.
     # 
     # For example, to remove the logical network `123` send a request like this:
     # 
@@ -13848,6 +15132,17 @@ module OvirtSDK4
     # DELETE /ovirt-engine/api/networks/123
     # ----
     # 
+    # Each network is bound exactly to one data center. So if we disassociate network with data center it has the same
+    # result as if we would just remove that network. However it might be more specific to say we're removing network
+    # `456` of data center `123`.
+    # 
+    # For example, to remove the association of network `456` to data center `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/datacenters/123/networks/456
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
@@ -13869,8 +15164,8 @@ module OvirtSDK4
     # Updates a logical network.
     # 
     # The `name`, `description`, `ip`, `vlan`, `stp` and `display` attributes can be updated.
-    # ⁠
-    # For example, to update the description of the logcial network `123` send a request like this:
+    # 
+    # For example, to update the description of the logical network `123` send a request like this:
     # 
     # [source]
     # ----
@@ -13886,6 +15181,26 @@ module OvirtSDK4
     # </network>
     # ----
     # 
+    # 
+    # The maximum transmission unit of a network is set using a PUT request to
+    # specify the integer value of the `mtu` attribute.
+    # 
+    # For example, to set the maximum transmission unit send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/datacenters/123/networks/456
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <network>
+    #   <mtu>1500</mtu>
+    # </network>
+    # ----
+    # 
     # @param network [Network] The `network` to update.
     # @param opts [Hash] Additional options.
     # 
@@ -13927,7 +15242,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `network_labels` service.
+    # Reference to the service that manages the network labels assigned to this network.
     # 
     # @return [NetworkLabelsService] A reference to `network_labels` service.
     # 
@@ -13936,7 +15251,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Reference to the service that manages the permissions assigned to this network.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -13945,7 +15260,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `vnic_profiles` service.
+    # Reference to the service that manages the vNIC profiles assigned to this network.
     # 
     # @return [AssignedVnicProfilesService] A reference to `vnic_profiles` service.
     # 
@@ -14505,7 +15820,7 @@ module OvirtSDK4
     # 
     # You can attach labels to a logical network to automate the association of that logical network with physical host
     # network interfaces to which the same label has been attached.
-    # ⁠
+    # 
     # For example, to attach the label `mylabel` to a logical network having id `123` send a request like this:
     # 
     # [source]
@@ -14641,7 +15956,7 @@ module OvirtSDK4
     end
     
     # 
-    # Creates new logical network.
+    # Creates a new logical network, or associates an existing network with a data center.
     # 
     # Creation of a new network requires the `name` and `data_center` elements.
     # 
@@ -14662,6 +15977,23 @@ module OvirtSDK4
     # </network>
     # ----
     # 
+    # 
+    # To associate the existing network `456` with the data center `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/networks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <network>
+    #   <name>ovirtmgmt</name>
+    # </network>
+    # ----
+    # 
     # @param network [Network] The `network` to add.
     # 
     # @param opts [Hash] Additional options.
@@ -14771,7 +16103,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `network` service.
+    # Reference to the service that manages a specific network.
     # 
     # @param id [String] The identifier of the `network`.
     # 
@@ -15489,6 +16821,13 @@ module OvirtSDK4
     # 
     # Returns the representation of the object managed by this service.
     # 
+    # For example, to get the OpenStack network provider with identifier `1234`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/openstacknetworkproviders/1234
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @return [OpenStackNetworkProvider]
@@ -15538,7 +16877,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the provider.
+    # 
+    # For example, to remove the OpenStack network provider with identifier `1234`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/openstacknetworkproviders/1234
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -15585,9 +16931,30 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `provider`.
+    # Updates the provider.
+    # 
+    # For example, to update `provider_name`, `requires_authentication`, `url`, `tenant_name` and `type` properties,
+    # for the OpenStack network provider with identifier `1234`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/openstacknetworkproviders/1234
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <openstack_network_provider>
+    #   <name>ovn-network-provider</name>
+    #   <requires_authentication>false</requires_authentication>
+    #   <url>http://some_server_url.domain.com:9696</url>
+    #   <tenant_name>oVirt</tenant_name>
+    #   <type>external</type>
+    # </openstack_network_provider>
+    # ----
     # 
-    # @param provider [OpenStackNetworkProvider] The `provider` to update.
+    # @param provider [OpenStackNetworkProvider] The provider to update.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -15637,7 +17004,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `networks` service.
+    # Reference to OpenStack networks service.
     # 
     # @return [OpenstackNetworksService] A reference to `networks` service.
     # 
@@ -15767,7 +17134,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `provider` service.
+    # Reference to OpenStack network provider service.
     # 
     # @param id [String] The identifier of the `provider`.
     # 
@@ -17125,7 +18492,23 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the information about the permit of the role.
+    # 
+    # For example to retrieve the information about the permit with the id `456` of the role with the id `123`
+    # send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/roles/123/permits/456
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <permit href="/ovirt-engine/api/roles/123/permits/456" id="456">
+    #   <name>change_vm_cd</name>
+    #   <administrative>false</administrative>
+    #   <role href="/ovirt-engine/api/roles/123" id="123"/>
+    # </permit>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17149,7 +18532,13 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the permit from the role.
+    # 
+    # For example to remove the permit with id `456` from the role with id `123` send a request like this:
+    # 
+    # ....
+    # DELETE /ovirt-engine/api/roles/123/permits/456
+    # ....
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17210,8 +18599,22 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a permit to the set aggregated by parent role. The permit must be one retrieved from the capabilities
-    # resource.
+    # Adds a permit to the role. The permit name can be retrieved from the <<services/cluster_levels>> service.
+    # 
+    # For example to assign a permit `create_vm` to the role with id `123` send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/roles/123/permits
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permit>
+    #   <name>create_vm</name>
+    # </permit>
+    # ----
     # 
     # @param permit [Permit] The permit to add.
     # 
@@ -17247,7 +18650,29 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List the permits of the role.
+    # 
+    # For example to list the permits of the role with the id `123` send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/roles/123/permits
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <permits>
+    #   <permit href="/ovirt-engine/api/roles/123/permits/5" id="5">
+    #     <name>change_vm_cd</name>
+    #     <administrative>false</administrative>
+    #     <role href="/ovirt-engine/api/roles/123" id="123"/>
+    #   </permit>
+    #   <permit href="/ovirt-engine/api/roles/123/permits/7" id="7">
+    #     <name>connect_to_vm</name>
+    #     <administrative>false</administrative>
+    #     <role href="/ovirt-engine/api/roles/123" id="123"/>
+    #   </permit>
+    # </permits>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18358,7 +19783,25 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get the role.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/roles/123
+    # ----
+    # 
+    # You will receive XML response like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <role id="123">
+    #   <name>MyRole</name>
+    #   <description>MyRole description</description>
+    #   <link href="/ovirt-engine/api/roles/123/permits" rel="permits"/>
+    #   <administrative>true</administrative>
+    #   <mutable>false</mutable>
+    # </role>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18431,7 +19874,7 @@ module OvirtSDK4
     # </group>
     # ----
     # 
-    # @param role [Role] The `role` to update.
+    # @param role [Role] Updated role.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -18472,7 +19915,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permits` service.
+    # Sub-resource locator method, returns permits service.
     # 
     # @return [PermitsService] A reference to `permits` service.
     # 
@@ -18553,7 +19996,7 @@ module OvirtSDK4
     # </group>
     # ----
     # 
-    # @param role [Role] The `role` to add.
+    # @param role [Role] Role that will be added.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18587,7 +20030,28 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List roles.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/roles
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <roles>
+    #   <role id="123">
+    #      <name>SuperUser</name>
+    #      <description>Roles management administrator</description>
+    #      <link href="/ovirt-engine/api/roles/123/permits" rel="permits"/>
+    #      <administrative>true</administrative>
+    #      <mutable>false</mutable>
+    #   </role>
+    #   ...
+    # </roles>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20263,7 +21727,63 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves a list of statistics.
+    # 
+    # For example, to retrieve the statistics for virtual machine `123` send a
+    # request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vms/123/statistics
+    # ----
+    # 
+    # The result will be like this:
+    # 
+    # [source,xml]
+    # ----
+    # <statistics>
+    #   <statistic href="/ovirt-engine/api/vms/123/statistics/456" id="456">
+    #     <name>memory.installed</name>
+    #     <description>Total memory configured</description>
+    #     <kind>gauge</kind>
+    #     <type>integer</type>
+    #     <unit>bytes</unit>
+    #     <values>
+    #       <value>
+    #         <datum>1073741824</datum>
+    #       </value>
+    #     </values>
+    #     <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    #   </statistic>
+    #   ...
+    # </statistics>
+    # ----
+    # 
+    # Just a single part of the statistics can be retrieved by specifying its id at the end of the URI. That means:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vms/123/statistics/456
+    # ----
+    # 
+    # Outputs:
+    # 
+    # [source,xml]
+    # ----
+    # <statistic href="/ovirt-engine/api/vms/123/statistics/456" id="456">
+    #   <name>memory.installed</name>
+    #   <description>Total memory configured</description>
+    #   <kind>gauge</kind>
+    #   <type>integer</type>
+    #   <unit>bytes</unit>
+    #   <values>
+    #     <value>
+    #       <datum>1073741824</datum>
+    #     </value>
+    #   </values>
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    # </statistic>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20350,15 +21870,33 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `end_` method.
+    # Marks an external step execution as ended.
+    # 
+    # For example, to terminate a step with identifier `456` which belongs to a `job` with identifier `123` send the
+    # following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/jobs/123/steps/456/end
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <force>true</force>
+    #   <succeeded>true</succeeded>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
-    # @option opts [Boolean] :force 
+    # @option opts [Boolean] :force Indicates if the step should be forcibly terminated.
     # 
-    # @option opts [Boolean] :succeeded 
+    # @option opts [Boolean] :succeeded Indicates the resolution of the step execution.
     # 
     def end_(opts = {})
       action = Action.new(opts)
@@ -20381,7 +21919,31 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves a step.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/jobs/123/steps/456
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <step href="/ovirt-engine/api/jobs/123/steps/456" id="456">
+    #   <actions>
+    #     <link href="/ovirt-engine/api/jobs/123/steps/456/end" rel="end"/>
+    #   </actions>
+    #   <description>Validating</description>
+    #   <end_time>2016-12-12T23:07:26.627+02:00</end_time>
+    #   <external>false</external>
+    #   <number>0</number>
+    #   <start_time>2016-12-12T23:07:26.605+02:00</start_time>
+    #   <status>finished</status>
+    #   <type>validating</type>
+    #   <job href="/ovirt-engine/api/jobs/123" id="123"/>
+    # </step>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20461,9 +22023,48 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `step`.
+    # Add an external step to an existing job or to an existing step.
+    # 
+    # For example, to add a step to `job` with identifier `123` send the
+    # following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/jobs/123/steps
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <step>
+    #   <description>Validating</description>
+    #   <start_time>2016-12-12T23:07:26.605+02:00</start_time>
+    #   <status>started</status>
+    #   <type>validating</type>
+    # </step>
+    # ----
+    # 
+    # The response should look like:
+    # 
+    # [source,xml]
+    # ----
+    # <step href="/ovirt-engine/api/jobs/123/steps/456" id="456">
+    #   <actions>
+    #     <link href="/ovirt-engine/api/jobs/123/steps/456/end" rel="end"/>
+    #   </actions>
+    #   <description>Validating</description>
+    #   <link href="/ovirt-engine/api/jobs/123/steps/456/statistics" rel="statistics"/>
+    #   <external>true</external>
+    #   <number>2</number>
+    #   <start_time>2016-12-13T01:06:15.380+02:00</start_time>
+    #   <status>started</status>
+    #   <type>validating</type>
+    #   <job href="/ovirt-engine/api/jobs/123" id="123"/>
+    # </step>
+    # ----
     # 
-    # @param step [Step] The `step` to add.
+    # @param step [Step] Step that will be added.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20497,7 +22098,34 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves the representation of the steps.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/job/123/steps
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <steps>
+    #   <step href="/ovirt-engine/api/jobs/123/steps/456" id="456">
+    #     <actions>
+    #       <link href="/ovirt-engine/api/jobs/123/steps/456/end" rel="end"/>
+    #     </actions>
+    #     <description>Validating</description>
+    #     <link href="/ovirt-engine/api/jobs/123/steps/456/statistics" rel="statistics"/>
+    #     <external>true</external>
+    #     <number>2</number>
+    #     <start_time>2016-12-13T01:06:15.380+02:00</start_time>
+    #     <status>started</status>
+    #     <type>validating</type>
+    #     <job href="/ovirt-engine/api/jobs/123" id="123"/>
+    #   </step>
+    #   ...
+    # </steps>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20528,7 +22156,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `step` service.
+    # Reference to the step service.
     # 
     # @param id [String] The identifier of the `step`.
     # 
@@ -22365,6 +23993,26 @@ module OvirtSDK4
     # </storage_domain>
     # ----
     # 
+    # To create a new iSCSI storage domain send a request like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_domain>
+    #   <name>myiscsi</name>
+    #   <type>data</type>
+    #   <storage>
+    #     <type>iscsi</type>
+    #     <logical_units>
+    #       <logical_unit id="3600144f09dbd050000004eedbd340001"/>
+    #       <logical_unit id="3600144f09dbd050000004eedbd340002"/>
+    #     </logical_units>
+    #   </storage>
+    #   <host>
+    #     <name>myhost</name>
+    #   </host>
+    # </storage_domain>
+    # ----
+    # 
     # @param storage_domain [StorageDomain] The `storage_domain` to add.
     # 
     # @param opts [Hash] Additional options.
@@ -23398,7 +25046,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `jobs` service.
+    # List all the jobs monitored by the engine.
     # 
     # @return [JobsService] A reference to `jobs` service.
     # 
@@ -23407,7 +25055,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `katello_errata` service.
+    # List the available Katello errata assigned to the engine.
     # 
     # @return [EngineKatelloErrataService] A reference to `katello_errata` service.
     # 
@@ -23857,9 +25505,66 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `permission`.
+    # Assign a new permission to a user or group for specific entity.
+    # 
+    # For example, to assign the `UserVmManager` role to the virtual machine with id `123` to the user with id `456`
+    # send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/vms/123/permissions
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permission>
+    #   <role>
+    #     <name>UserVmManager</name>
+    #   </role>
+    #   <user id="456"/>
+    # </permission>
+    # ----
+    # 
+    # To assign the `SuperUser` role to the system to the user with id `456` send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/permissions
+    # ....
     # 
-    # @param permission [Permission] The `permission` to add.
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permission>
+    #   <role>
+    #     <name>SuperUser</name>
+    #   </role>
+    #   <user id="456"/>
+    # </permission>
+    # ----
+    # 
+    # If you want to assign permission to the group instead of the user please replace the `user` element with the
+    # `group` element with proper `id` of the group. For example to assign the `UserRole` role to the cluster with
+    # id `123` to the group with id `789` send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/clusters/123/permissions
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <permission>
+    #   <role>
+    #     <name>UserRole</name>
+    #   </role>
+    #   <group id="789"/>
+    # </permission>
+    # ----
+    # 
+    # @param permission [Permission] The permission.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23893,7 +25598,29 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all the permissions of the specific entity.
+    # 
+    # For example to list all the permissions of the cluster with id `123` send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/clusters/123/permissions
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <permissions>
+    #   <permission id="456">
+    #     <cluster id="123"/>
+    #     <role id="789"/>
+    #     <user id="451"/>
+    #   </permission>
+    #   <permission id="654">
+    #     <cluster id="123"/>
+    #     <role id="789"/>
+    #     <group id="127"/>
+    #   </permission>
+    # </permissions>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23974,7 +25701,21 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the information about the tag.
+    # 
+    # For example to retrieve the information about the tag with the id `123` send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/tags/123
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <tag href="/ovirt-engine/api/tags/123" id="123">
+    #   <name>root</name>
+    #   <description>root</description>
+    # </tag>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -23998,7 +25739,13 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the tag from the system.
+    # 
+    # For example to remove the tag with id `123` send a request like this:
+    # 
+    # ....
+    # DELETE /ovirt-engine/api/tags/123
+    # ....
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -24018,9 +25765,36 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `tag`.
+    # Updates the tag entity.
+    # 
+    # For example to update parent tag to tag with id `456` of the tag with id `123` send a request like this:
     # 
-    # @param tag [Tag] The `tag` to update.
+    # ....
+    # PUT /ovirt-engine/api/tags/123
+    # ....
+    # 
+    # With request body like:
+    # 
+    # [source,xml]
+    # ----
+    # <tag>
+    #   <parent id="456"/>
+    # </tag>
+    # ----
+    # 
+    # You may also specify a tag name instead of id. For example to update parent tag to tag with name `mytag`
+    # of the tag with id `123` send a request like this:
+    # 
+    # [source,xml]
+    # ----
+    # <tag>
+    #   <parent>
+    #     <name>mytag</name>
+    #   </parent>
+    # </tag>
+    # ----
+    # 
+    # @param tag [Tag] The updated tag.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -24102,9 +25876,39 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `tag`.
+    # Add a new tag to the system.
+    # 
+    # For example, to add new tag with name `mytag` to the system send a request like this:
+    # 
+    # ....
+    # POST /ovirt-engine/api/tags
+    # ....
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <tag>
+    #   <name>mytag</name>
+    # </tag>
+    # ----
+    # 
+    # NOTE: The root tag is a special pseudo-tag assumed as the default parent tag if no parent tag is specified.
+    # The root tag cannot be deleted nor assigned a parent tag.
+    # 
+    # To create new tag with specific parent tag send a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <tag>
+    #   <name>mytag</name>
+    #   <parent>
+    #     <name>myparenttag</name>
+    #   </parent>
+    # </tag>
+    # ----
     # 
-    # @param tag [Tag] The `tag` to add.
+    # @param tag [Tag] The added tag.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -24138,7 +25942,40 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List the tags in the system.
+    # 
+    # For example to list the full hierarchy of the tags in the system send a request like this:
+    # 
+    # ....
+    # GET /ovirt-engine/api/tags
+    # ....
+    # 
+    # [source,xml]
+    # ----
+    # <tags>
+    #   <tag href="/ovirt-engine/api/tags/222" id="222">
+    #     <name>root2</name>
+    #     <description>root2</description>
+    #     <parent href="/ovirt-engine/api/tags/111" id="111"/>
+    #   </tag>
+    #   <tag href="/ovirt-engine/api/tags/333" id="333">
+    #     <name>root3</name>
+    #     <description>root3</description>
+    #     <parent href="/ovirt-engine/api/tags/222" id="222"/>
+    #   </tag>
+    #   <tag href="/ovirt-engine/api/tags/111" id="111">
+    #     <name>root</name>
+    #     <description>root</description>
+    #   </tag>
+    # </tags>
+    # ----
+    # 
+    # In the previous XML output you can see the following hierarchy of the tags:
+    # ....
+    # root:        (id: 111)
+    #   - root2    (id: 222)
+    #     - root3  (id: 333)
+    # ....
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -24169,7 +26006,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `tag` service.
+    # Reference to the service that manages a specific tag.
     # 
     # @param id [String] The identifier of the `tag`.
     # 
@@ -24274,7 +26111,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the information about this template or template version.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -24305,7 +26142,7 @@ module OvirtSDK4
     end
     
     # 
-    # Removas a virtual machine template.
+    # Removes a virtual machine template.
     # 
     # [source]
     # ----
@@ -24404,7 +26241,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `cdroms` service.
+    # Returns a reference to the service that manages the CDROMs that are associated with the template.
     # 
     # @return [TemplateCdromsService] A reference to `cdroms` service.
     # 
@@ -24432,7 +26269,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `nics` service.
+    # Returns a reference to the service that manages the NICs that are associated with the template.
     # 
     # @return [TemplateNicsService] A reference to `nics` service.
     # 
@@ -24441,7 +26278,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Returns a reference to the service that manages the permissions that are associated with the template.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -24450,7 +26287,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `tags` service.
+    # Returns a reference to the service that manages the tags that are associated with the template.
     # 
     # @return [AssignedTagsService] A reference to `tags` service.
     # 
@@ -24459,7 +26296,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `watchdogs` service.
+    # Returns a reference to the service that manages the _watchdogs_ that are associated with the template.
     # 
     # @return [TemplateWatchdogsService] A reference to `watchdogs` service.
     # 
@@ -24551,7 +26388,14 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the information about this CD-ROM device.
+    # 
+    # For example, to get information about the CD-ROM device of template `123` send a request like:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/templates/123/cdroms/
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -24620,7 +26464,7 @@ module OvirtSDK4
     # 
     # @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.
+    # @option opts [Integer] :max Sets the maximum number of CD-ROMs to return. If not specified all the CD-ROMs are returned.
     # 
     # @return [Array<Cdrom>]
     # 
@@ -24647,7 +26491,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `cdrom` service.
+    # Returns a reference to the service that manages a specific CD-ROM device.
     # 
     # @param id [String] The identifier of the `cdrom`.
     # 
@@ -25650,7 +27494,7 @@ module OvirtSDK4
     # </template>
     # ----
     # 
-    # @param template [Template] The `template` to add.
+    # @param template [Template] The information about the template or template version.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25712,7 +27556,16 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of virtual machine templates.
+    # 
+    # For example:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/templates
+    # ----
+    # 
+    # Will return the list of virtual machines and virtual machine templates.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25765,7 +27618,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `template` service.
+    # Returns a reference to the service that manages a specific virtual machine template.
     # 
     # @param id [String] The identifier of the `template`.
     # 
@@ -25993,7 +27846,36 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Gets the system user information.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/users/1234
+    # ....
+    # 
+    # Will return the user information:
+    # 
+    # [source,xml]
+    # ----
+    # <user href="/ovirt-engine/api/users/1234" id="1234">
+    #   <name>admin</name>
+    #   <link href="/ovirt-engine/api/users/1234/sshpublickeys" rel="sshpublickeys"/>
+    #   <link href="/ovirt-engine/api/users/1234/roles" rel="roles"/>
+    #   <link href="/ovirt-engine/api/users/1234/permissions" rel="permissions"/>
+    #   <link href="/ovirt-engine/api/users/1234/tags" rel="tags"/>
+    #   <department></department>
+    #   <domain_entry_id>23456</domain_entry_id>
+    #   <email>user1@domain.com</email>
+    #   <last_name>Lastname</last_name>
+    #   <namespace>*</namespace>
+    #   <principal>user1</principal>
+    #   <user_name>user1@domain-authz</user_name>
+    #   <domain href="/ovirt-engine/api/domains/45678" id="45678">
+    #     <name>domain-authz</name>
+    #   </domain>
+    # </user>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -26017,7 +27899,13 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the system user.
+    # 
+    # Usage:
+    # 
+    # ....
+    # DELETE /ovirt-engine/api/users/1234
+    # ....
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -26212,7 +28100,35 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all the users in the system.
+    # 
+    # Usage:
+    # 
+    # ....
+    # GET /ovirt-engine/api/users
+    # ....
+    # 
+    # Will return the list of users:
+    # 
+    # [source,xml]
+    # ----
+    # <users>
+    #   <user href="/ovirt-engine/api/users/1234" id="1234">
+    #     <name>admin</name>
+    #     <link href="/ovirt-engine/api/users/1234/sshpublickeys" rel="sshpublickeys"/>
+    #     <link href="/ovirt-engine/api/users/1234/roles" rel="roles"/>
+    #     <link href="/ovirt-engine/api/users/1234/permissions" rel="permissions"/>
+    #     <link href="/ovirt-engine/api/users/1234/tags" rel="tags"/>
+    #     <domain_entry_id>23456</domain_entry_id>
+    #     <namespace>*</namespace>
+    #     <principal>user1</principal>
+    #     <user_name>user1@domain-authz</user_name>
+    #     <domain href="/ovirt-engine/api/domains/45678" id="45678">
+    #       <name>domain-authz</name>
+    #     </domain>
+    #   </user>
+    # </users>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27528,7 +29444,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `katello_errata` service.
+    # Reference to the service that can show the applicable errata available on the virtual machine.
+    # This information is taken from Katello.
     # 
     # @return [KatelloErrataService] A reference to `katello_errata` service.
     # 
@@ -27755,7 +29672,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the information about the application.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27827,7 +29744,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns a list of applications installed in the virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27865,7 +29782,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `application` service.
+    # Returns a reference to the service that provides information about a specific application.
     # 
     # @param id [String] The identifier of the `application`.
     # 
@@ -27923,6 +29840,28 @@ module OvirtSDK4
     # 
     # Returns the information about this CDROM device.
     # 
+    # The information consists of `cdrom` attribute containing reference to the CDROM device, the virtual machine,
+    # and optionally the inserted disk.
+    # 
+    # If there is a disk inserted then the `file` attribute will contain a reference to the ISO image:
+    # 
+    # [source,xml]
+    # ----
+    # <cdrom href="..." id="00000000-0000-0000-0000-000000000000">
+    #   <file id="mycd.iso"/>
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    # </cdrom>
+    # ----
+    # 
+    # If there is no disk inserted then the `file` attribute won't be reported:
+    # 
+    # [source,xml]
+    # ----
+    # <cdrom href="..." id="00000000-0000-0000-0000-000000000000">
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    # </cdrom>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :current Indicates if the operation should return the information for the currently running virtual machine. This
@@ -27953,7 +29892,58 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the information about this CDROM device.
+    # Updates the information about this CDROM device.
+    # 
+    # It allows to change or eject the disk by changing the value of the `file` attribute.
+    # For example, to insert or change the disk send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000
+    # ----
+    # 
+    # The body should contain the new value for the `file` attribute:
+    # 
+    # [source,xml]
+    # ----
+    # <cdrom>
+    #   <file id="mycd.iso"/>
+    # </cdrom>
+    # ----
+    # 
+    # The value of the `id` attribute, `mycd.iso` in this example, should correspond to a file available in an
+    # attached ISO storage domain.
+    # 
+    # To eject the disk use a `file` with an empty `id`:
+    # 
+    # [source,xml]
+    # ----
+    # <cdrom>
+    #   <file id=""/>
+    # </cdrom>
+    # ----
+    # 
+    # By default the above operations change permanently the disk that will be visible to the virtual machine
+    # after the next boot, but they don't have any effect on the currently running virtual machine. If you want
+    # to change the disk that is visible to the current running virtual machine, add the `current=true` parameter.
+    # For example, to eject the current disk send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vms/123/cdroms/00000000-0000-0000-0000-000000000000?current=true
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <cdrom>
+    #   <file id=""/>
+    # </cdrom>
+    # ----
+    # 
+    # IMPORTANT: The changes made with the `current=true` parameter are never persisted, so they won't have any
+    # effect after the virtual machine is rebooted.
     # 
     # @param cdrom [Cdrom] The information about the CDROM device.
     # @param opts [Hash] Additional options.
@@ -28652,7 +30642,35 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieve information about particular host device attached to given virtual machine.
+    # 
+    # Example:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vms/123/hostdevices/456
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <host_device href="/ovirt-engine/api/hosts/543/devices/456" id="456">
+    #   <name>pci_0000_04_00_0</name>
+    #   <capability>pci</capability>
+    #   <iommu_group>30</iommu_group>
+    #   <placeholder>true</placeholder>
+    #   <product id="0x13ba">
+    #     <name>GM107GL [Quadro K2200]</name>
+    #   </product>
+    #   <vendor id="0x10de">
+    #     <name>NVIDIA Corporation</name>
+    #   </vendor>
+    #   <host href="/ovirt-engine/api/hosts/543" id="543"/>
+    #   <parent_device href="/ovirt-engine/api/hosts/543/devices/456" id="456">
+    #     <name>pci_0000_00_03_0</name>
+    #   </parent_device>
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    # </host_device>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28676,7 +30694,17 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove the attachment of this host device from given virtual machine.
+    # 
+    # NOTE: In case this device serves as an IOMMU placeholder, it cannot be removed (remove will result only
+    # in setting its `placeholder` flag to `true`). Note that all IOMMU placeholder devices will be removed
+    # automatically as soon as there will be no more non-placeholder devices (all devices from given IOMMU
+    # group are detached).
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vms/123/hostdevices/456
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28737,9 +30765,33 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `device`.
+    # Attach target device to given virtual machine.
+    # 
+    # Example:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/hostdevices
+    # ----
+    # 
+    # With request body of type <<types/host_device,HostDevice>>, for example
+    # 
+    # [source,xml]
+    # ----
+    # <host_device id="123" />
+    # ----
+    # 
+    # NOTE: A necessary precondition for a successful host device attachment is that the virtual machine must be pinned
+    # to *exactly* one host. The device ID is then taken relative to this host.
     # 
-    # @param device [HostDevice] The `device` to add.
+    # NOTE: Attachment of a PCI device that is part of a bigger IOMMU group will result in attachment of the remaining
+    # devices from that IOMMU group as "placeholders". These devices are then identified using the `placeholder`
+    # attribute of the <<types/host_device,HostDevice>> type set to `true`.
+    # 
+    # In case you want attach a device that already serves as an IOMMU placeholder, simply issue an explicit Add operation
+    # for it, and its `placeholder` flag will be cleared, and the device will be accessible to the virtual machine.
+    # 
+    # @param device [HostDevice] The host device to be attached to given virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28773,7 +30825,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List the host devices assigned to given virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28804,7 +30856,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `device` service.
+    # Returns a reference to the service that manages a specific host device attached to given virtual machine.
     # 
     # @param id [String] The identifier of the `device`.
     # 
@@ -28993,6 +31045,7 @@ module OvirtSDK4
     # <nic>
     #   <name>mynic</name>
     #   <interface>e1000</interface>
+    #   <vnic_profile id='789'/>
     # </nic>
     # ----
     # 
@@ -29361,9 +31414,7 @@ module OvirtSDK4
     # <vm_numa_node>
     #   <numa_node_pins>
     #     <numa_node_pin>
-    #       <host_numa_node id="789"/>
     #       <index>0</index>
-    #       <pinned>true</pinned>
     #     </numa_node_pin>
     #   </numa_node_pins>
     # </vm_numa_node>
@@ -29638,7 +31689,33 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get the virtual machine pool.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vmpools/123
+    # ----
+    # 
+    # You will get a XML response like that one:
+    # [source,xml]
+    # ----
+    # <vm_pool id="123">
+    #   <actions>...</actions>
+    #   <name>MyVmPool</name>
+    #   <description>MyVmPool description</description>
+    #   <link href="/ovirt-engine/api/vmpools/123/permissions" rel="permissions"/>
+    #   <max_user_vms>1</max_user_vms>
+    #   <prestarted_vms>0</prestarted_vms>
+    #   <size>100</size>
+    #   <stateful>false</stateful>
+    #   <type>automatic</type>
+    #   <use_latest_template_version>false</use_latest_template_version>
+    #   <cluster id="123"/>
+    #   <template id="123"/>
+    #   <vm id="123">...</vm>
+    #   ...
+    # </vm_pool>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29757,7 +31834,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Reference to a service managing the virtual machine pool assigned permissions.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -29834,7 +31911,7 @@ module OvirtSDK4
     # </vmpool>
     # ----
     # 
-    # @param pool [VmPool] The `pool` to add.
+    # @param pool [VmPool] Pool to add.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29868,7 +31945,24 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get a list of available virtual machines pools.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vmpools
+    # ----
+    # 
+    # You will receive the following response:
+    # 
+    # [source,xml]
+    # ----
+    # <vm_pools>
+    #   <vm_pool id="123">
+    #     ...
+    #   </vm_pool>
+    #   ...
+    # </vm_pools>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29921,7 +32015,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `pool` service.
+    # Reference to the service that manages a specific virtual machine pool.
     # 
     # @param id [String] The identifier of the `pool`.
     # 
@@ -30305,7 +32399,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the information about the watchdog.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30329,7 +32423,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the watchdog from the virtual machine.
+    # 
+    # For example, to remove a watchdog from a virtual machine, send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vms/123/watchdogs/00000000-0000-0000-0000-000000000000
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30349,9 +32450,36 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `watchdog`.
+    # Updates the information about the watchdog.
     # 
-    # @param watchdog [Watchdog] The `watchdog` to update.
+    # You can update the information using `action` and `model` elements.
+    # 
+    # For example, to update a watchdog, send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vms/123/watchdogs
+    # <watchdog>
+    #   <action>reset</action>
+    # </watchdog>
+    # ----
+    # 
+    # with response body:
+    # 
+    # [source,xml]
+    # ----
+    # <watchdog href="/ovirt-engine/api/vms/123/watchdogs/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000">
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    #   <action>reset</action>
+    #   <model>i6300esb</model>
+    # </watchdog>
+    # ----
+    # 
+    # @param watchdog [Watchdog] The information about the watchdog.
+    #   
+    #   The request data must contain at least one of `model` and `action`
+    #   elements. The response data contains complete information about the
+    #   updated watchdog.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -30433,9 +32561,35 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `watchdog`.
+    # Adds new watchdog to the virtual machine.
     # 
-    # @param watchdog [Watchdog] The `watchdog` to add.
+    # For example, to add a watchdog to a virtual machine, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/watchdogs
+    # <watchdog>
+    #   <action>poweroff</action>
+    #   <model>i6300esb</model>
+    # </watchdog>
+    # ----
+    # 
+    # with response body:
+    # 
+    # [source,xml]
+    # ----
+    # <watchdog href="/ovirt-engine/api/vms/123/watchdogs/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000">
+    #   <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    #   <action>poweroff</action>
+    #   <model>i6300esb</model>
+    # </watchdog>
+    # ----
+    # 
+    # @param watchdog [Watchdog] The information about the watchdog.
+    #   
+    #   The request data must contain `model` element (such as `i6300esb`) and `action` element
+    #   (one of `none`, `reset`, `poweroff`, `dump`, `pause`). The response data additionally
+    #   contains references to the added watchdog and to the virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30469,7 +32623,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # The list of watchdogs of the virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30500,7 +32654,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `watchdog` service.
+    # Returns a reference to the service that manages a specific watchdog.
     # 
     # @param id [String] The identifier of the `watchdog`.
     # 
@@ -30944,7 +33098,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves details about a vNIC profile.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30968,7 +33122,7 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the vNIC profile.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30988,9 +33142,9 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `profile`.
+    # Updates details of a vNIC profile.
     # 
-    # @param profile [VnicProfile] The `profile` to update.
+    # @param profile [VnicProfile] The vNIC profile that is being updated.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -31087,9 +33241,72 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `profile`.
+    # Add a vNIC profile.
     # 
-    # @param profile [VnicProfile] The `profile` to add.
+    # For example to add vNIC profile `123` to network `456` send a request to:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/networks/456/vnicprofiles
+    # ----
+    # 
+    # With the following body:
+    # 
+    # [source,xml]
+    # ----
+    # <vnic_profile id="123">
+    #   <name>new_vNIC_name</name>
+    #   <pass_through>
+    #     <mode>disabled</mode>
+    #   </pass_through>
+    #   <port_mirroring>false</port_mirroring>
+    # </vnic_profile>
+    # ----
+    # 
+    # Please note that there is a default network filter to each VNIC profile.
+    # For more details of how the default network filter is calculated please refer to
+    # the documentation in <<services/network_filters,NetworkFilters>>.
+    # 
+    # The output of creating a new VNIC profile depends in the  body  arguments that were given.
+    # In case no network filter was given, the default network filter will be configured. For example:
+    # 
+    # [source,xml]
+    # ----
+    # <vnic_profile href="/ovirt-engine/api/vnicprofiles/123" id="123">
+    #   <name>new_vNIC_name</name>
+    #   <link href="/ovirt-engine/api/vnicprofiles/123/permissions" rel="permissions"/>
+    #   <pass_through>
+    #     <mode>disabled</mode>
+    #   </pass_through>
+    #   <port_mirroring>false</port_mirroring>
+    #   <network href="/ovirt-engine/api/networks/456" id="456"/>
+    #   <network_filter href="/ovirt-engine/api/networkfilters/789" id="789"/>
+    # </vnic_profile>
+    # ----
+    # 
+    # In case an empty network filter was given, no network filter will be configured for the specific VNIC profile
+    # regardless of the VNIC profile's default network filter. For example:
+    # 
+    # [source,xml]
+    # ----
+    # <vnic_profile>
+    #   <name>no_network_filter</name>
+    #   <network_filter/>
+    # </vnic_profile>
+    # ----
+    # 
+    # In case that a specific valid network filter id was given, the VNIC profile will be configured with the given
+    # network filter regardless of the VNIC profiles's default network filter. For example:
+    # 
+    # [source,xml]
+    # ----
+    # <vnic_profile>
+    #   <name>user_choice_network_filter</name>
+    #   <network_filter id= "0000001b-001b-001b-001b-0000000001d5"/>
+    # </vnic_profile>
+    # ----
+    # 
+    # @param profile [VnicProfile] The vNIC profile that is being added.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -31123,7 +33340,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all vNIC profiles.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -31678,7 +33895,36 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves the representation of the Katello errata.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/katelloerrata
+    # ----
+    # 
+    # You will receive response in XML like this one:
+    # 
+    # [source,xml]
+    # ----
+    # <katello_errata>
+    #   <katello_erratum href="/ovirt-engine/api/katelloerrata/123" id="123">
+    #     <name>RHBA-2013:XYZ</name>
+    #     <description>The description of the erratum</description>
+    #     <title>some bug fix update</title>
+    #     <type>bugfix</type>
+    #     <issued>2013-11-20T02:00:00.000+02:00</issued>
+    #     <solution>Few guidelines regarding the solution</solution>
+    #     <summary>Updated packages that fix one bug are now available for XYZ</summary>
+    #     <packages>
+    #       <package>
+    #         <name>libipa_hbac-1.9.2-82.11.el6_4.i686</name>
+    #       </package>
+    #       ...
+    #     </packages>
+    #   </katello_erratum>
+    #   ...
+    # </katello_errata>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -31709,7 +33955,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `katello_erratum` service.
+    # Reference to the Katello erratum service.
+    # Use this service to view the erratum by its id.
     # 
     # @param id [String] The identifier of the `katello_erratum`.
     # 
@@ -32022,7 +34269,54 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get details of a brick.
+    # 
+    # Retrieves status details of brick from underlying gluster volume with header `All-Content` set to `true`. This is
+    # the equivalent of running `gluster volume status <volumename> <brickname> detail`.
+    # 
+    # For example, to get the details of brick `234` of gluster volume `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/234
+    # ----
+    # 
+    # Which will return a response body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <brick id="234">
+    #   <name>host1:/rhgs/data/brick1</name>
+    #   <brick_dir>/rhgs/data/brick1</brick_dir>
+    #   <server_id>111</server_id>
+    #   <status>up</status>
+    #   <device>/dev/mapper/RHGS_vg1-lv_vmaddldisks</device>
+    #   <fs_name>xfs</fs_name>
+    #   <gluster_clients>
+    #     <gluster_client>
+    #       <bytes_read>2818417648</bytes_read>
+    #       <bytes_written>1384694844</bytes_written>
+    #       <client_port>1011</client_port>
+    #       <host_name>client2</host_name>
+    #     </gluster_client>
+    #   </gluster_clients>
+    #   <memory_pools>
+    #     <memory_pool>
+    #       <name>data-server:fd_t</name>
+    #       <alloc_count>1626348</alloc_count>
+    #       <cold_count>1020</cold_count>
+    #       <hot_count>4</hot_count>
+    #       <max_alloc>23</max_alloc>
+    #       <max_stdalloc>0</max_stdalloc>
+    #       <padded_size>140</padded_size>
+    #       <pool_misses>0</pool_misses>
+    #     </memory_pool>
+    #   </memory_pools>
+    #   <mnt_options>rw,seclabel,noatime,nodiratime,attr2,inode64,sunit=512,swidth=2048,noquota</mnt_options>
+    #   <pid>25589</pid>
+    #   <port>49155</port>
+    # </brick>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32046,7 +34340,18 @@ module OvirtSDK4
     end
     
     # 
-    # Removes this brick from the volume and deletes it from the database.
+    # Removes a brick.
+    # 
+    # Removes a brick from the underlying gluster volume and deletes entries from database. This can be used only when
+    # removing a single brick without data migration. To remove multiple bricks and with data migration, use
+    # <<services/gluster_bricks/methods/migrate, migrate>> instead.
+    # 
+    # For example, to delete brick `234` from gluster volume `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/clusters/567/glustervolumes/123/glusterbricks/234
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32066,7 +34371,11 @@ module OvirtSDK4
     end
     
     # 
-    # Replaces this brick with a new one. The property `brick` is required.
+    # Replaces this brick with a new one.
+    # 
+    # IMPORTANT: This operation has been deprecated since version 3.5 of the engine and will be removed in the future.
+    # Use <<services/gluster_bricks/methods/add, add brick(s)>> and
+    # <<services/gluster_bricks/methods/migrate, migrate brick(s)>> instead.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32151,7 +34460,47 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get the gluster volume details.
+    # 
+    # For example, to get details of a gluster volume with identifier `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/clusters/456/glustervolumes/123
+    # ----
+    # 
+    # This GET request will return the following output:
+    # 
+    # [source,xml]
+    # ----
+    # <gluster_volume id="123">
+    #  <name>data</name>
+    #  <link href="/ovirt-engine/api/clusters/456/glustervolumes/123/glusterbricks" rel="glusterbricks"/>
+    #  <disperse_count>0</disperse_count>
+    #  <options>
+    #    <option>
+    #      <name>storage.owner-gid</name>
+    #      <value>36</value>
+    #    </option>
+    #    <option>
+    #      <name>performance.io-cache</name>
+    #      <value>off</value>
+    #    </option>
+    #    <option>
+    #      <name>cluster.data-self-heal-algorithm</name>
+    #      <value>full</value>
+    #    </option>
+    #  </options>
+    #  <redundancy_count>0</redundancy_count>
+    #  <replica_count>3</replica_count>
+    #  <status>up</status>
+    #  <stripe_count>0</stripe_count>
+    #  <transport_types>
+    #    <transport_type>tcp</transport_type>
+    #  </transport_types>
+    #  <volume_type>replicate</volume_type>
+    #  </gluster_volume>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32175,11 +34524,19 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `get_profile_statistics` method.
+    # Get gluster volume profile statistics.
+    # 
+    # For example, to get profile statistics for a gluster volume with identifier `123` in cluster `456`, send a
+    # request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/getprofilestatistics
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [GlusterVolumeProfileDetails] :details 
+    # @option opts [GlusterVolumeProfileDetails] :details Gluster volume profiling information returned from the action.
     # 
     def get_profile_statistics(opts = {})
       action = Action.new(opts)
@@ -32203,15 +34560,30 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `rebalance` method.
+    # Rebalance the gluster volume.
+    # 
+    # Rebalancing a gluster volume helps to distribute the data evenly across all the bricks. After expanding or
+    # shrinking a gluster volume (without migrating data), we need to rebalance the data among the bricks. In a
+    # non-replicated volume, all bricks should be online to perform the rebalance operation. In a replicated volume, at
+    # least one of the bricks in the replica should be online.
+    # 
+    # For example, to rebalance a gluster volume with identifier `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/rebalance
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the rebalance should be performed asynchronously.
     # 
-    # @option opts [Boolean] :fix_layout 
+    # @option opts [Boolean] :fix_layout If set to true, rebalance will only fix the layout so that new data added to the volume is distributed
+    #   across all the hosts. But it will not migrate/rebalance the existing data. Default is `false`.
     # 
-    # @option opts [Boolean] :force 
+    # @option opts [Boolean] :force Indicates if the rebalance should be force started. The rebalance command can be executed with the force
+    #   option even when the older clients are connected to the cluster. However, this could lead to a data loss
+    #   situation. Default is `false`.
     # 
     def rebalance(opts = {})
       action = Action.new(opts)
@@ -32234,7 +34606,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the gluster volume.
+    # 
+    # For example, to remove a volume with identifier `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/clusters/456/glustervolumes/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32254,7 +34633,15 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `reset_all_options` method.
+    # Resets all the options set in the gluster volume.
+    # 
+    # For example, to reset all options in a gluster volume with identifier `123` in cluster `456`, send a request like
+    # this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetalloptions
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32281,7 +34668,24 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `reset_option` method.
+    # Resets a particular option in the gluster volume.
+    # 
+    # For example, to reset a particular option `option1` in a gluster volume with identifier `123` in cluster `456`,
+    # send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/resetoption
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #  <option name="option1"/>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32289,7 +34693,7 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :force 
     # 
-    # @option opts [Option] :option 
+    # @option opts [Option] :option Option to reset.
     # 
     def reset_option(opts = {})
       action = Action.new(opts)
@@ -32312,13 +34716,30 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `set_option` method.
+    # Sets a particular option in the gluster volume.
+    # 
+    # For example, to set `option1` with value `value1` in a gluster volume with identifier `123` in cluster `456`,
+    # send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/setoption
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #  <option name="option1" value="value1"/>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
-    # @option opts [Option] :option 
+    # @option opts [Option] :option Option to set.
     # 
     def set_option(opts = {})
       action = Action.new(opts)
@@ -32341,13 +34762,22 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `start` method.
+    # Starts the gluster volume.
+    # 
+    # A Gluster Volume should be started to read/write data. For example, to start a gluster volume with identifier
+    # `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/start
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
     # 
-    # @option opts [Boolean] :force 
+    # @option opts [Boolean] :force Indicates if the volume should be force started. If a gluster volume is started already but few/all bricks
+    #   are down then force start can be used to bring all the bricks up. Default is `false`.
     # 
     def start(opts = {})
       action = Action.new(opts)
@@ -32370,7 +34800,14 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `start_profile` method.
+    # Start profiling the gluster volume.
+    # 
+    # For example, to start profiling a gluster volume with identifier `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/startprofile
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32397,7 +34834,16 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `stop` method.
+    # Stops the gluster volume.
+    # 
+    # Stopping a volume will make its data inaccessible.
+    # 
+    # For example, to stop a gluster volume with identifier `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/stop
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32426,7 +34872,14 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `stop_profile` method.
+    # Stop profiling the gluster volume.
+    # 
+    # For example, to stop profiling a gluster volume with identifier `123` in cluster `456`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/stopprofile
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32453,7 +34906,15 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `stop_rebalance` method.
+    # Stop rebalancing the gluster volume.
+    # 
+    # For example, to stop rebalancing a gluster volume with identifier `123` in cluster `456`, send a request like
+    # this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/456/glustervolumes/123/stoprebalance
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -32480,7 +34941,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `gluster_bricks` service.
+    # Reference to a service managing gluster bricks.
     # 
     # @return [GlusterBricksService] A reference to `gluster_bricks` service.
     # 
@@ -32932,15 +35393,15 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `iscsi_discover` method.
+    # Discover iSCSI targets on the host, using the initiator details.
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the discovery should be performed asynchronously.
     # 
-    # @option opts [IscsiDetails] :iscsi 
+    # @option opts [IscsiDetails] :iscsi The target iSCSI device.
     # 
-    # @option opts [Array<String>] :iscsi_targets 
+    # @option opts [Array<String>] :iscsi_targets The iSCSI targets.
     # 
     def iscsi_discover(opts = {})
       action = Action.new(opts)
@@ -32964,13 +35425,13 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `iscsi_login` method.
+    # Login to iSCSI targets on the host, using the target details.
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the login should be performed asynchronously.
     # 
-    # @option opts [IscsiDetails] :iscsi 
+    # @option opts [IscsiDetails] :iscsi The target iSCSI device.
     # 
     def iscsi_login(opts = {})
       action = Action.new(opts)
@@ -32993,7 +35454,7 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `refresh` method.
+    # Refresh the host devices and capabilities.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -33365,7 +35826,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `devices` service.
+    # Reference to the host devices service.
+    # Use this service to view the devices of the host object.
     # 
     # @return [HostDevicesService] A reference to `devices` service.
     # 
@@ -33374,7 +35836,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `fence_agents` service.
+    # Reference to the fence agents service.
+    # Use this service to manage fence and power management agents on the host object.
     # 
     # @return [FenceAgentsService] A reference to `fence_agents` service.
     # 
@@ -33383,7 +35846,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `hooks` service.
+    # Reference to the host hooks service.
+    # Use this service to view the hooks available in the host object.
     # 
     # @return [HostHooksService] A reference to `hooks` service.
     # 
@@ -33392,7 +35856,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `katello_errata` service.
+    # Reference to the service that can show the applicable errata available on the host.
+    # This information is taken from Katello.
     # 
     # @return [KatelloErrataService] A reference to `katello_errata` service.
     # 
@@ -33401,7 +35866,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `network_attachments` service.
+    # Reference to the network attachments service. You can use this service to attach
+    # Logical networks to host interfaces.
     # 
     # @return [NetworkAttachmentsService] A reference to `network_attachments` service.
     # 
@@ -33419,7 +35885,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `numa_nodes` service.
+    # Reference to the service that manage NUMA nodes for the host.
     # 
     # @return [HostNumaNodesService] A reference to `numa_nodes` service.
     # 
@@ -33428,7 +35894,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `permissions` service.
+    # Reference to the host permission service.
+    # Use this service to manage permissions on the host object.
     # 
     # @return [AssignedPermissionsService] A reference to `permissions` service.
     # 
@@ -33446,7 +35913,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `storage` service.
+    # Reference to the service that manage hosts storage.
     # 
     # @return [HostStorageService] A reference to `storage` service.
     # 
@@ -33455,7 +35922,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `storage_connection_extensions` service.
+    # Reference to storage connection extensions.
     # 
     # @return [StorageServerConnectionExtensionsService] A reference to `storage_connection_extensions` service.
     # 
@@ -33464,7 +35931,8 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `tags` service.
+    # Reference to the host tags service.
+    # Use this service to manage tags on the host object.
     # 
     # @return [AssignedTagsService] A reference to `tags` service.
     # 
@@ -33473,7 +35941,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `unmanaged_networks` service.
+    # Reference to unmanaged networks.
     # 
     # @return [UnmanagedNetworksService] A reference to `unmanaged_networks` service.
     # 
@@ -33666,7 +36134,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `network_attachments` service.
+    # Reference to the service that manages the network attachments assigned to this network interface.
     # 
     # @return [NetworkAttachmentsService] A reference to `network_attachments` service.
     # 
@@ -33675,7 +36143,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `network_labels` service.
+    # Reference to the service that manages the network labels assigned to this network interface.
     # 
     # @return [NetworkLabelsService] A reference to `network_labels` service.
     #