ovirt-engine-sdk 4.0.5 → 4.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5fa8b2c41d6e4de3707932c34fb215d2991894ac
-  data.tar.gz: a5d2dc254baded75ff8c10dd658d261c1e84a835
+  metadata.gz: 8e5bfa1388e71cd3c46306600f1684f33840cab9
+  data.tar.gz: 1aef00ac9898fe1ee30e31d8bde8be4f3b6ec01c
 SHA512:
-  metadata.gz: 53fc1b7b12b9a89fbc48831cd817e2d6163057bf569b96234c716cb980803092982acb86a49b991d3bf6c54fb57190568000d4c1fb193435b5c0c5786ba99392
-  data.tar.gz: c5a1888b7aa6bd2334ff1524a29a7d2978e519c50aa86e67807bd24ac21a700582d3e3a7ca3293f45360d918f82659a9fe9a5a00a78bbc44ad19918eaa2df0af
+  metadata.gz: 575ee5fd660bfe4747f22c0dd56bb36ee7ef4f688f30bc92fe1acec76f208d40a31e9d555b274df2afba03dd869a4a516e5ddd1d543ed0304005ae661ff60c76
+  data.tar.gz: 008405cdde7b82e2f07b7cf15a5f6d741d887fe7a64070d4b96bbfa1fc76ecac36ed9dcfc55d579d41533448e945bdac59d92238c77ec8ac061b009dd66dac24

data/CHANGES.adoc

@@ -2,6 +2,49 @@
 
 This document describes the relevant changes between releases of the SDK.
 
+== 4.0.6 / Oct 18 2016
+
+Update to model 4.0.37.
+
+New features:
+
+* Add services to support disk attachments of virtual machines available
+  for import from storage domains.
+
+* Add `gluster` value to the `NetworkUsage` enum.
+
+* Add `force` parameter to the operation that updates a storage server
+  connection.
+
+Bug fixes:
+
+* Fix the type of the `ticket` parameter of the `VmService.ticket`
+  method.
+
+* Fix the type of the `authentication_method` attribute of the `Ssh`
+  type.
+
+* Rename the `AuthenticationMethod` enum type to `SshAuthenticationMethod`.
+
+* Fix the name of the `exclusive` parameter o the `TemplateService.export`
+  method.
+
+* Add the missing `cluster` parameter to the `OpenstackImageService.import`
+  method.
+
+* Move the `quota` link from the `Vm` type to the `VmBase` type.
+
+* Add missing `template` and `storage_domain` parameters to the
+  operation that imports an image.
+
+* Add the `next_run` parameter to the operation that updates a virtual
+  machine.
+
+* Add the `all_content` parameters to the operations that list and
+  retrieve virtual machines.
+
+* Implement `==` and `eql?` for types https://bugzilla.redhat.com/1383613[#1383613].
+
 == 4.0.5 / Oct 7 2016
 
 Bug Fixes:

data/lib/ovirtsdk4.rb

@@ -28,7 +28,7 @@ require 'ovirtsdk4c'
 # Own requirements.
 #
 require 'ovirtsdk4/version.rb'
-require 'ovirtsdk4/http.rb'
+require 'ovirtsdk4/connection.rb'
 require 'ovirtsdk4/type.rb'
 require 'ovirtsdk4/types.rb'
 require 'ovirtsdk4/reader.rb'

data/lib/ovirtsdk4/{http.rb → connection.rb}

@@ -138,7 +138,7 @@ module OvirtSDK4
         request.url = "#{@url}#{request.url}"
       end
 
-      # Set the headers:
+      # Set the headers common to all requests:
       request.headers.merge!(
         'User-Agent'   => "RubySDK/#{VERSION}",
         'Version'      => '4',
@@ -146,6 +146,16 @@ module OvirtSDK4
         'Accept'       => 'application/xml',
       )
 
+      # Older versions of the engine (before 4.1) required the 'all_content' as an HTTP header instead of a query
+      # parameter. In order to better support those older versions of the engine we need to check if this parameter is
+      # included in the request, and add the corresponding header.
+      unless request.query.nil?
+        all_content = request.query['all_content']
+        unless all_content.nil?
+          request.headers['All-Content'] = all_content
+        end
+      end
+
       # Set the authentication token:
       @token ||= get_access_token
       request.token = @token

data/lib/ovirtsdk4/readers.rb

@@ -48,8 +48,6 @@ module OvirtSDK4
       object.discard_snapshots = value if not value.nil?
       value = reader.get_attribute('exclusive')
       object.exclusive = value if not value.nil?
-      value = reader.get_attribute('exclussive')
-      object.exclussive = value if not value.nil?
       value = reader.get_attribute('fence_type')
       object.fence_type = value if not value.nil?
       value = reader.get_attribute('filter')
@@ -135,8 +133,6 @@ module OvirtSDK4
           object.disks = DiskReader.read_many(reader)
         when 'exclusive'
           object.exclusive = Reader.read_boolean(reader)
-        when 'exclussive'
-          object.exclussive = Reader.read_boolean(reader)
         when 'fault'
           object.fault = FaultReader.read_one(reader)
         when 'fence_type'
@@ -1922,8 +1918,6 @@ module OvirtSDK4
           object.gluster_hooks = GlusterHookReader.read_many(reader)
         when 'gluster_volumes'
           object.gluster_volumes = GlusterVolumeReader.read_many(reader)
-        when 'mac_pool'
-          object.mac_pool = MacPoolReader.read_one(reader)
         when 'management_network'
           object.management_network = NetworkReader.read_one(reader)
         when 'network_filters'
@@ -8184,6 +8178,8 @@ module OvirtSDK4
           object.nics = NicReader.read_many(reader)
         when 'permissions'
           object.permissions = PermissionReader.read_many(reader)
+        when 'quota'
+          object.quota = QuotaReader.read_one(reader)
         when 'storage_domain'
           object.storage_domain = StorageDomainReader.read_one(reader)
         when 'tags'
@@ -15650,6 +15646,8 @@ module OvirtSDK4
           object.nics = NicReader.read_many(reader)
         when 'permissions'
           object.permissions = PermissionReader.read_many(reader)
+        when 'quota'
+          object.quota = QuotaReader.read_one(reader)
         when 'storage_domain'
           object.storage_domain = StorageDomainReader.read_one(reader)
         when 'tags'
@@ -17272,6 +17270,8 @@ module OvirtSDK4
           object.cluster = ClusterReader.read_one(reader)
         when 'cpu_profile'
           object.cpu_profile = CpuProfileReader.read_one(reader)
+        when 'quota'
+          object.quota = QuotaReader.read_one(reader)
         when 'storage_domain'
           object.storage_domain = StorageDomainReader.read_one(reader)
         else

data/lib/ovirtsdk4/services.rb

@@ -551,6 +551,12 @@ module OvirtSDK4
   class StorageDomainVmService < Service
   end
   
+  class StorageDomainVmDiskAttachmentService < Service
+  end
+  
+  class StorageDomainVmDiskAttachmentsService < Service
+  end
+  
   class StorageDomainVmsService < Service
   end
   
@@ -757,7 +763,17 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieve the affinity group details.
+    # 
+    # [source,xml]
+    # ----
+    # <affinity_group id="00000000-0000-0000-0000-000000000000">
+    #   <name>AF_GROUP_001</name>
+    #   <cluster id="00000000-0000-0000-0000-000000000000"/>
+    #   <positive>true</positive>
+    #   <enforcing>true</enforcing>
+    # </affinity_group>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -781,7 +797,12 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove the affinity group.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/clusters/000-000/affinitygroups/123-456
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -801,9 +822,9 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `group`.
+    # Update the affinity group.
     # 
-    # @param group [AffinityGroup] The `group` to update.
+    # @param group [AffinityGroup] The affinity group.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -844,7 +865,9 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `vms` service.
+    # Returns a reference to the service that manages the
+    # list of all virtual machines attached to this affinity
+    # group.
     # 
     # @return [AffinityGroupVmsService] A reference to `vms` service.
     def vms_service
@@ -899,7 +922,7 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove this virtual machine from the affinity group.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -960,7 +983,21 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `vm`.
+    # Add a virtual machine to the affinity group.
+    # 
+    # For example to add the virtual machine 000-000 to affinity group 123-456 send a request to:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/000-000/affinitygroups/123-456/vms
+    # ----
+    # 
+    # With the following body:
+    # 
+    # [source,xml]
+    # ----
+    # <vm id="000-000"/>
+    # ----
     # 
     # @param vm [Vm] The `vm` to add.
     # 
@@ -983,7 +1020,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VmReader.read_one(reader)
@@ -996,7 +1033,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List all virtual machines assigned to this affinity group.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -1028,7 +1065,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `vm` service.
+    # Access the service that manages the virtual machine assignment to this affinity group.
     # 
     # @param id [String] The identifier of the `vm`.
     # 
@@ -1084,9 +1121,27 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `group`.
+    # Create a new affinity group.
+    # 
+    # Post a request like in the example below to create a new affinity group:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters/000-000/affinitygroups
+    # ----
+    # 
+    # And use the following example in its body:
+    # 
+    # [source,xml]
+    # ----
+    # <affinity_group>
+    #   <name>AF_GROUP_001</name>
+    #   <positive>true</positive>
+    #   <enforcing>true</enforcing>
+    # </affinity_group>
+    # ----
     # 
-    # @param group [AffinityGroup] The `group` to add.
+    # @param group [AffinityGroup] The affinity group object to create.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -1107,7 +1162,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return AffinityGroupReader.read_one(reader)
@@ -1120,7 +1175,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List existing affinity groups.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -1151,7 +1206,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `group` service.
+    # Access affinity group service that manages the affinity group specified by an id.
     # 
     # @param id [String] The identifier of the `group`.
     # 
@@ -1456,7 +1511,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return HostReader.read_one(reader)
@@ -1652,7 +1707,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VmReader.read_one(reader)
@@ -1770,7 +1825,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return AffinityLabelReader.read_one(reader)
@@ -1972,7 +2027,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return AffinityLabelReader.read_one(reader)
@@ -2174,7 +2229,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return CpuProfileReader.read_one(reader)
@@ -2382,7 +2437,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return DiskProfileReader.read_one(reader)
@@ -2633,7 +2688,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NetworkReader.read_one(reader)
@@ -2756,7 +2811,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return PermissionReader.read_one(reader)
@@ -3045,7 +3100,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return TagReader.read_one(reader)
@@ -3267,7 +3322,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VnicProfileReader.read_one(reader)
@@ -3367,7 +3422,21 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `activate` method.
+    # This operation activates an attached storage domain.
+    # Once the storage domain is activated it is ready for use with the data center.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/storagedomains/456/activate
+    # ----
+    # 
+    # The activate action does not take any action specific parameters,
+    # so the request body should contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3394,7 +3463,21 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `deactivate` method.
+    # This operation deactivates an attached storage domain.
+    # Once the storage domain is deactivated it will not be used with the data center.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/storagedomains/456/deactivate
+    # ----
+    # 
+    # The deactivate action does not take any action specific parameters,
+    # so the request body should contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -3543,7 +3626,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return StorageDomainReader.read_one(reader)
@@ -3758,7 +3841,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return BalanceReader.read_one(reader)
@@ -4016,7 +4099,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return BookmarkReader.read_one(reader)
@@ -4147,7 +4230,12 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes cluster from the system.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/clusters/00000000-0000-0000-0000-000000000000
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -4194,7 +4282,27 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `cluster`.
+    # Updates information about the cluster.
+    # 
+    # Only specified fields are updated, others remain unchanged.
+    # 
+    # E.g. update cluster's CPU:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/clusters/123
+    # ----
+    # 
+    # With request body like:
+    # 
+    # [source,xml]
+    # ----
+    # <cluster>
+    #   <cpu>
+    #     <type>Intel Haswell-noTSX Family</type>
+    #   </cpu>
+    # </cluster>
+    # ----
     # 
     # @param cluster [Cluster] The `cluster` to update.
     # @param opts [Hash] Additional options.
@@ -4521,7 +4629,28 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `cluster`.
+    # Creates a new cluster.
+    # 
+    # This requires the `name`, `cpu.type` and `data_center` attributes. Identify the data center with either the `id`
+    # or `name` attributes.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/clusters
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <cluster>
+    #   <name>mycluster</name>
+    #   <cpu>
+    #     <type>Intel Penryn Family</type>
+    #   </cpu>
+    #   <data_center id="123"/>
+    # </cluster>
+    # ----
     # 
     # @param cluster [Cluster] The `cluster` to add.
     # 
@@ -4544,7 +4673,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return ClusterReader.read_one(reader)
@@ -4899,7 +5028,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return CpuProfileReader.read_one(reader)
@@ -5032,6 +5161,11 @@ module OvirtSDK4
     # 
     # Removes the data center.
     # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/datacenters/123
+    # ----
+    # 
     # Without any special parameters, the storage domains attached to the data center are detached and then removed
     # from the storage. If something fails when performing this operation, for example if there is no host available to
     # remove the storage domains from the storage, the complete operation will fail.
@@ -5067,9 +5201,27 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `data_center`.
+    # Updates the data center.
+    # 
+    # The `name`, `description`, `storage_type`, `version`, `storage_format` and `mac_pool` elements are updatable
+    # post-creation. For example, to change the name and description of data center `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/datacenters/123
+    # ----
+    # 
+    # With a request body like this:
     # 
-    # @param data_center [DataCenter] The `data_center` to update.
+    # [source,xml]
+    # ----
+    # <data_center>
+    #   <name>myupdatedname</name>
+    #   <description>An updated description for the data center</description>
+    # </data_center>
+    # ----
+    # 
+    # @param data_center [DataCenter] The data center that is being updated.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -5158,7 +5310,30 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `storage_domains` service.
+    # Attach and detach storage domains to and from a data center.
+    # 
+    # For attaching a single storage domain we should use the folowing POST request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/storagedomains
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_domain>
+    #   <name>data1</name>
+    # </storage_domain>
+    # ----
+    # 
+    # For detaching a single storage domain we should use the folowing DELETE request:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/datacenters/123/storagedomains/123
+    # ----
     # 
     # @return [AttachedStorageDomainsService] A reference to `storage_domains` service.
     def storage_domains_service
@@ -5249,9 +5424,27 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `data_center`.
+    # Creates a new data center.
+    # 
+    # Creation of a new data center requires the `name` and `local` elements. For example, to create a data center
+    # named `mydc` that uses shared storage (NFS, iSCSI or fibre channel) send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <data_center>
+    #   <name>mydc</name>
+    #   <local>false</local>
+    # </data_center>
+    # ----
     # 
-    # @param data_center [DataCenter] The `data_center` to add.
+    # @param data_center [DataCenter] The data center that is being added.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -5272,7 +5465,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return DataCenterReader.read_one(reader)
@@ -5285,7 +5478,63 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists the data centers.
+    # 
+    # The following request retrieves a representation of the data centers:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/datacenters
+    # ----
+    # 
+    # The above request performed with `curl`:
+    # 
+    # [source,bash]
+    # ----
+    # curl \
+    # --request GET \
+    # --cacert /etc/pki/ovirt-engine/ca.pem \
+    # --header "Version: 4" \
+    # --header "Accept: application/xml" \
+    # --user "admin@internal:mypassword" \
+    # https://myengine.example.com/ovirt-engine/api/datacenters
+    # ----
+    # 
+    # This is what an example response could look like:
+    # 
+    # [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/networks" rel="networks"/>
+    #   <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/clusters" rel="clusters"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/qoss" rel="qoss"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/iscsibonds" rel="iscsibonds"/>
+    #   <link href="/ovirt-engine/api/datacenters/123/quotas" rel="quotas"/>
+    #   <local>false</local>
+    #   <quota_mode>disabled</quota_mode>
+    #   <status>up</status>
+    #   <supported_versions>
+    #     <version>
+    #       <major>4</major>
+    #       <minor>0</minor>
+    #     </version>
+    #   </supported_versions>
+    #   <version>
+    #     <major>4</major>
+    #     <minor>0</minor>
+    #   </version>
+    # </data_center>
+    # ----
+    # 
+    # Note the `id` code of your `Default` data center. This code identifies this data center in relation to other
+    # resources of your virtual environment.
+    # 
+    # The data center also contains a link to the storage domains collection. The data center uses this collection to
+    # attach storage domains from the storage domains main collection.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -5560,6 +5809,13 @@ module OvirtSDK4
     # 
     # In this case the disk will be created and then attached to the virtual machine.
     # 
+    # In both cases, use the following URL for a virtual machine with an id `345`:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/345/diskattachments
+    # ----
+    # 
     # @param attachment [DiskAttachment] The `attachment` to add.
     # 
     # @param opts [Hash] Additional options.
@@ -5581,7 +5837,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return DiskAttachmentReader.read_one(reader)
@@ -5839,7 +6095,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return DiskProfileReader.read_one(reader)
@@ -6111,7 +6367,31 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `disk`.
+    # 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:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/disks
+    # ----
+    # 
+    # With a request body as follows:
+    # 
+    # [source,xml]
+    # ----
+    # <disk>
+    #   <storage_domains>
+    #     <storage_domain id="e9fedf39-5edc-4e0a-8628-253f1b9c5693"/>
+    #   </storage_domains>
+    #   <name>disk1</name>
+    #   <provisioned_size>1048576</provisioned_size>
+    #   <format>cow</format>
+    # </disk>
+    # ----
     # 
     # @param disk [Disk] The `disk` to add.
     # 
@@ -6134,7 +6414,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return DiskReader.read_one(reader)
@@ -6787,7 +7067,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes an event from internal audit log.
+    # 
+    # An event can be removed by sending following request
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/events/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6905,7 +7192,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return EventReader.read_one(reader)
@@ -6918,7 +7205,47 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get list of events.
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/events
+    # ----
+    # 
+    # To the above request we get following reponse:
+    # 
+    # [source,xml]
+    # ----
+    # <events>
+    #   <event href="/ovirt-engine/api/events/2" id="2">
+    #     <description>User admin@internal-authz logged out.</description>
+    #     <code>31</code>
+    #     <correlation_id>1e892ea9</correlation_id>
+    #     <custom_id>-1</custom_id>
+    #     <flood_rate>30</flood_rate>
+    #     <origin>oVirt</origin>
+    #     <severity>normal</severity>
+    #     <time>2016-09-14T12:14:34.541+02:00</time>
+    #     <user href="/ovirt-engine/api/users/57d91d48-00da-0137-0138-000000000244" id="57d91d48-00da-0137-0138-000000000244"/>
+    #   </event>
+    #   <event href="/ovirt-engine/api/events/1" id="1">
+    #     <description>User admin logged in.</description>
+    #     <code>30</code>
+    #     <correlation_id>1fbd81f4</correlation_id>
+    #     <custom_id>-1</custom_id>
+    #     <flood_rate>30</flood_rate>
+    #     <origin>oVirt</origin>
+    #     <severity>normal</severity>
+    #     <time>2016-09-14T11:54:35.229+02:00</time>
+    #     <user href="/ovirt-engine/api/users/57d91d48-00da-0137-0138-000000000244" id="57d91d48-00da-0137-0138-000000000244"/>
+    #   </event>
+    # </events>
+    # ----
+    # 
+    # The following events occur:
+    # 
+    # * id="1" - The API logs in the admin user account.
+    # * id="2" - The API logs out of the admin user account.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -6941,7 +7268,68 @@ module OvirtSDK4
     # 
     # @option opts [Integer] :max Sets the maximum number of events to return. If not specified all the events are returned.
     # 
-    # @option opts [String] :search A query string used to restrict the returned events.
+    # @option opts [String] :search The events service provides search queries similar to other resource services.
+    #   
+    #   We can search by providing specific severity.
+    #   
+    #   [source]
+    #   ----
+    #   GET /ovirt-engine/api/events?search=severity%3Dnormal
+    #   ----
+    #   
+    #   To the above request we get a list of events which severity is equal to `normal`:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <events>
+    #     <event href="/ovirt-engine/api/events/2" id="2">
+    #       <description>User admin@internal-authz logged out.</description>
+    #       <code>31</code>
+    #       <correlation_id>1fbd81f4</correlation_id>
+    #       <custom_id>-1</custom_id>
+    #       <flood_rate>30</flood_rate>
+    #       <origin>oVirt</origin>
+    #       <severity>normal</severity>
+    #       <time>2016-09-14T11:54:35.229+02:00</time>
+    #       <user href="/ovirt-engine/api/users/57d91d48-00da-0137-0138-000000000244" id="57d91d48-00da-0137-0138-000000000244"/>
+    #     </event>
+    #     <event href="/ovirt-engine/api/events/1" id="1">
+    #       <description>Affinity Rules Enforcement Manager started.</description>
+    #       <code>10780</code>
+    #       <custom_id>-1</custom_id>
+    #       <flood_rate>30</flood_rate>
+    #       <origin>oVirt</origin>
+    #       <severity>normal</severity>
+    #       <time>2016-09-14T11:52:18.861+02:00</time>
+    #     </event>
+    #   </events>
+    #   ----
+    #   
+    #   A virtualization environment generates a large amount of events after
+    #   a period of time. However, the API only displays a default number of
+    #   events for one search query. To display more than the default, the API
+    #   separates results into pages with the page command in a search query.
+    #   The following search query tells the API to paginate results using a
+    #   page value in combination with the sortby clause:
+    #   
+    #   [source]
+    #   ----
+    #   sortby time asc page 1
+    #   ----
+    #   
+    #   Below example paginates event resources. The URL-encoded request is:
+    #   
+    #   [source]
+    #   ----
+    #   GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%201
+    #   ----
+    #   
+    #   Increase the page value to view the next page of results.
+    #   
+    #   [source]
+    #   ----
+    #   GET /ovirt-engine/api/events?search=sortby%20time%20asc%20page%202
+    #   ----
     # 
     # @return [Array<Event>]
     # 
@@ -7609,7 +7997,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return ExternalHostProviderReader.read_one(reader)
@@ -8107,7 +8495,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return ExternalVmImportReader.read_one(reader)
@@ -8312,7 +8700,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return AgentReader.read_one(reader)
@@ -8694,7 +9082,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return FilterReader.read_one(reader)
@@ -8859,7 +9247,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return GlusterBrickReader.read_many(reader)
@@ -9334,7 +9722,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return GlusterVolumeReader.read_one(reader)
@@ -9571,7 +9959,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return GraphicsConsoleReader.read_one(reader)
@@ -9812,7 +10200,27 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `group`.
+    # Add group from a directory service. Please note that domain name is name of the authorization provider.
+    # 
+    # For example, to add the `Developers` group from the `internal-authz` authorization provider send a request
+    # like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/groups
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <group>
+    #   <name>Developers</name>
+    #   <domain>
+    #     <name>internal-authz</name>
+    #   </domain>
+    # </group>
+    # ----
     # 
     # @param group [Group] The `group` to add.
     # 
@@ -9835,7 +10243,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return GroupReader.read_one(reader)
@@ -10563,24 +10971,51 @@ module OvirtSDK4
     end
     
     # 
-    # Creates a new host and adds it to the database. The host is created based on the properties of the `host`
-    # parameter. The `name`, `address` `rootPassword` properties are required.
+    # Creates a new host.
+    # 
+    # The host is created based on the attributes of the `host` parameter. The `name`, `address` and `root_password`
+    # properties are required.
+    # 
+    # For example, to add a host send the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <host>
+    #   <name>myhost</name>
+    #   <address>myhost.example.com</address>
+    #   <root_password>myrootpassword</root_password>
+    # </host>
+    # ----
+    # 
+    # NOTE: The `root_password` element is only included in the client-provided initial representation and is not
+    # exposed in the representations returned from subsequent requests.
+    # 
+    # To add a hosted engine host, use the optional `deploy_hosted_engine` parameter:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts?deploy_hosted_engine=true
+    # ----
     # 
     # @param host [Host] The host definition from which to create the new host is passed as parameter, and the newly created host
     #   is returned.
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should deploy also hosted
-    #   engine components. Missing value is treated as `true` i.e deploy.
-    #   Omitting this parameter means `false` and will perform no operation
-    #   in hosted engine area.
+    # @option opts [Boolean] :deploy_hosted_engine When set to `true` it means this host should deploy also hosted engine components. Missing value is treated
+    #   as `true` i.e deploy. Omitting this parameter means `false` and will perform no operation in hosted engine
+    #   area.
     # 
-    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy hosted engine
-    #   components and this host will not function as part of the High
-    #   Availability cluster. Missing value is treated as `true` i.e un-deploy.
-    #   Omitting this parameter means `false` and will perform no operation
-    #   in hosted engine area.
+    # @option opts [Boolean] :undeploy_hosted_engine When set to `true` it means this host should un-deploy hosted engine components and this host will not
+    #   function as part of the High Availability cluster. Missing value is treated as `true` i.e un-deploy.
+    #   Omitting this parameter means `false` and will perform no operation in hosted engine area.
     # 
     # @return [Host]
     # 
@@ -10609,7 +11044,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return HostReader.read_one(reader)
@@ -10913,11 +11348,17 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the import should be performed asynchronously.
     # 
-    # @option opts [Cluster] :cluster 
+    # @option opts [Cluster] :cluster Cluster where the image should be imported. Has effect only in case `import_as_template` parameter
+    #   is set to `true`.
     # 
-    # @option opts [Disk] :disk 
+    # @option opts [Disk] :disk The disk which should be imported.
     # 
-    # @option opts [Boolean] :import_as_template 
+    # @option opts [Boolean] :import_as_template Specify if template should be created from the imported disk.
+    # 
+    # @option opts [StorageDomain] :storage_domain Storage domain where disk should be imported.
+    # 
+    # @option opts [Template] :template Name of the template, which should be created. Has effect only in case `import_as_template` parameter
+    #   is set to `true`.
     # 
     def import(opts = {})
       action = Action.new(opts)
@@ -11187,7 +11628,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return ImageTransferReader.read_one(reader)
@@ -11690,7 +12131,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NicReader.read_one(reader)
@@ -11941,7 +12382,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return WatchdogReader.read_one(reader)
@@ -12064,7 +12505,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return InstanceTypeReader.read_one(reader)
@@ -12188,7 +12629,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes of an exisitng iSCSI bond.
+    # 
+    # For example, to remove the iSCSI bond `456` send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/datacenters/123/iscsibonds/456
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12208,12 +12656,30 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `bond`.
+    # Updates an iSCSI bond.
     # 
-    # @param bond [IscsiBond] The `bond` to update.
-    # @param opts [Hash] Additional options.
-    # 
-    # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
+    # Updating of an iSCSI bond can be done on the `name` and the `description` attributes only. For example, to
+    # update the iSCSI bond `456` of data center `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/datacenters/123/iscsibonds/1234
+    # ----
+    # 
+    # The request body should look like this:
+    # 
+    # [source,xml]
+    # ----
+    # <iscsi_bond>
+    #    <name>mybond</name>
+    #    <description>My iSCSI bond</description>
+    # </iscsi_bond>
+    # ----
+    # 
+    # @param bond [IscsiBond] The `bond` to update.
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
     # 
     # @return [IscsiBond]
     # 
@@ -12320,7 +12786,31 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `bond`.
+    # Create a new iSCSI bond on a data center.
+    # 
+    # For example, to create a new iSCSI bond on data center `123` using storage connections `456` and `789`, send a
+    # request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/iscsibonds
+    # ----
+    # 
+    # The request body should look like this:
+    # 
+    # [source,xml]
+    # ----
+    # <iscsi_bond>
+    #   <name>mybond</name>
+    #   <storage_connections>
+    #     <storage_connection id="456"/>
+    #     <storage_connection id="789"/>
+    #   </storage_connections>
+    #   <networks>
+    #     <network id="abc"/>
+    #   </networks>
+    # </iscsi_bond>
+    # ----
     # 
     # @param bond [IscsiBond] The `bond` to add.
     # 
@@ -12343,7 +12833,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return IscsiBondReader.read_one(reader)
@@ -12601,7 +13091,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return JobReader.read_one(reader)
@@ -12877,7 +13367,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a MAC address pool.
+    # 
+    # For example, to remove the MAC address pool having id `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/macpools/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -12897,7 +13394,37 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `pool`.
+    # Updates a MAC address pool.
+    # 
+    # The `name`, `description`, `allow_duplicates`, and `ranges` attributes can be updated.
+    # 
+    # For example, to update the MAC address pool of id `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/macpools/123
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <mac_pool>
+    #   <name>UpdatedMACPool</name>
+    #   <description>An updated MAC address pool</description>
+    #   <allow_duplicates>false</allow_duplicates>
+    #   <ranges>
+    #     <range>
+    #       <from>00:1A:4A:16:01:51</from>
+    #       <to>00:1A:4A:16:01:e6</to>
+    #     </range>
+    #     <range>
+    #       <from>02:1A:4A:01:00:00</from>
+    #       <to>02:1A:4A:FF:FF:FF</to>
+    #     </range>
+    #   </ranges>
+    # </mac_pool>
+    # ----
     # 
     # @param pool [MacPool] The `pool` to update.
     # @param opts [Hash] Additional options.
@@ -12981,7 +13508,34 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `pool`.
+    # Creates a new MAC address pool.
+    # 
+    # Creation of a MAC address pool requires values for the `name` and `ranges` attributes.
+    # 
+    # For example, to create MAC address pool send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/macpools
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <mac_pool>
+    #   <name>MACPool</name>
+    #   <description>A MAC address pool</description>
+    #   <allow_duplicates>true</allow_duplicates>
+    #   <default_pool>false</default_pool>
+    #   <ranges>
+    #     <range>
+    #       <from>00:1A:4A:16:01:51</from>
+    #       <to>00:1A:4A:16:01:e6</to>
+    #     </range>
+    #   </ranges>
+    # </mac_pool>
+    # ----
     # 
     # @param pool [MacPool] The `pool` to add.
     # 
@@ -13004,7 +13558,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return MacPoolReader.read_one(reader)
@@ -13251,7 +13805,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a logical network.
+    # 
+    # For example, to remove the logical network `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/networks/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13271,7 +13832,25 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `network`.
+    # 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:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/networks/123
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <network>
+    #   <description>My updated description</description>
+    # </network>
+    # ----
     # 
     # @param network [Network] The `network` to update.
     # @param opts [Hash] Additional options.
@@ -13548,7 +14127,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NetworkAttachmentReader.read_one(reader)
@@ -13817,7 +14396,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a label from a logical network.
+    # 
+    # For example, to remove the label `exemplary` from a logical network having id `123` send the following request:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/networks/123/labels/exemplary
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -13878,7 +14464,24 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `label`.
+    # Attaches label to logical network.
+    # 
+    # 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]
+    # ----
+    # POST /ovirt-engine/api/networks/123/labels
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <label id="mylabel"/>
+    # ----
     # 
     # @param label [NetworkLabel] The `label` to add.
     # 
@@ -13901,7 +14504,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NetworkLabelReader.read_one(reader)
@@ -14001,7 +14604,26 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `network`.
+    # Creates new logical network.
+    # 
+    # Creation of a new network requires the `name` and `data_center` elements.
+    # 
+    # For example, to create a network named `mynetwork` for data center `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/networks
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <network>
+    #   <name>mynetwork</name>
+    #   <data_center id="123"/>
+    # </network>
+    # ----
     # 
     # @param network [Network] The `network` to add.
     # 
@@ -14024,7 +14646,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NetworkReader.read_one(reader)
@@ -14037,7 +14659,36 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # List logical networks.
+    # 
+    # For example:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/networks
+    # ----
+    # 
+    # Will respond:
+    # 
+    # [source,xml]
+    # ----
+    # <networks>
+    #   <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>
+    #   ...
+    # </networks>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14163,15 +14814,40 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `import` method.
+    # Imports a virtual machine from a Glance image storage domain.
+    # 
+    # For example, to import the image with identifier `456` from the
+    # storage domain with identifier `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/openstackimageproviders/123/images/456/import
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain>
+    #     <name>images0</name>
+    #   </storage_domain>
+    #   <cluster>
+    #     <name>images0</name>
+    #   </cluster>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the import should be performed asynchronously.
     # 
+    # @option opts [Cluster] :cluster This parameter is mandatory in case of using `import_as_template` and indicates which cluster should be used
+    #   for import glance image as template.
+    # 
     # @option opts [Disk] :disk 
     # 
-    # @option opts [Boolean] :import_as_template 
+    # @option opts [Boolean] :import_as_template Indicates whether the image should be imported as a template.
     # 
     # @option opts [StorageDomain] :storage_domain 
     # 
@@ -14472,7 +15148,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return OpenStackImageProviderReader.read_one(reader)
@@ -14572,7 +15248,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists the images of a Glance image storage domain.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -14603,7 +15279,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `image` service.
+    # Returns a reference to the service that manages a specific image.
     # 
     # @param id [String] The identifier of the `image`.
     # 
@@ -15005,7 +15681,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return OpenStackNetworkProviderReader.read_one(reader)
@@ -15300,7 +15976,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return OpenStackSubnetReader.read_one(reader)
@@ -15544,7 +16220,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return OpenstackVolumeAuthenticationKeyReader.read_one(reader)
@@ -15868,7 +16544,31 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `provider`.
+    # Adds a new volume provider.
+    # 
+    # For example:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/openstackvolumeproviders
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <openstack_volume_provider>
+    #   <name>mycinder</name>
+    #   <url>https://mycinder.example.com:8776</url>
+    #   <data_center>
+    #     <name>mydc</name>
+    #   </data_center>
+    #   <requires_authentication>true</requires_authentication>
+    #   <username>admin</username>
+    #   <password>mypassword</password>
+    #   <tenant_name>mytenant</tenant_name>
+    # </openstack_volume_provider>
+    # ----
     # 
     # @param provider [OpenStackVolumeProvider] The `provider` to add.
     # 
@@ -15891,7 +16591,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return OpenStackVolumeProviderReader.read_one(reader)
@@ -15904,7 +16604,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves the list of volume providers.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16489,7 +17189,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return PermitReader.read_one(reader)
@@ -16740,7 +17440,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return QosReader.read_one(reader)
@@ -16840,7 +17540,26 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Retrieves a quota.
+    # 
+    # An example of retrieving a quota:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/datacenters/123/quotas/456
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <quota id="456">
+    #   <name>myquota</name>
+    #   <description>My new quota for virtual machines</description>
+    #   <cluster_hard_limit_pct>20</cluster_hard_limit_pct>
+    #   <cluster_soft_limit_pct>80</cluster_soft_limit_pct>
+    #   <storage_hard_limit_pct>20</storage_hard_limit_pct>
+    #   <storage_soft_limit_pct>80</storage_soft_limit_pct>
+    # </quota>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16864,7 +17583,17 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Delete a quota.
+    # 
+    # An example of deleting a quota:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/datacenters/123-456/quotas/654-321
+    # -0472718ab224 HTTP/1.1
+    # Accept: application/xml
+    # Content-type: application/xml
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -16884,7 +17613,24 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `quota`.
+    # Updates a quota.
+    # 
+    # An example of updating a quota:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/datacenters/123/quotas/456
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <quota>
+    #   <cluster_hard_limit_pct>30</cluster_hard_limit_pct>
+    #   <cluster_soft_limit_pct>70</cluster_soft_limit_pct>
+    #   <storage_hard_limit_pct>20</storage_hard_limit_pct>
+    #   <storage_soft_limit_pct>80</storage_soft_limit_pct>
+    # </quota>
+    # ----
     # 
     # @param quota [Quota] The `quota` to update.
     # @param opts [Hash] Additional options.
@@ -17118,7 +17864,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return QuotaClusterLimitReader.read_one(reader)
@@ -17326,7 +18072,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return QuotaStorageLimitReader.read_one(reader)
@@ -17426,7 +18172,22 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `quota`.
+    # Creates a new quota.
+    # 
+    # An example of creating a new quota:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/datacenters/123/quotas
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <quota>
+    #   <name>myquota</name>
+    #   <description>My new quota for virtual machines</description>
+    # </quota>
+    # ----
     # 
     # @param quota [Quota] The `quota` to add.
     # 
@@ -17449,7 +18210,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return QuotaReader.read_one(reader)
@@ -17462,7 +18223,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists quotas of a data center
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17573,7 +18334,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the role.
+    # 
+    # To remove the role you need to know its id, then send request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/roles/{role_id}
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -17593,7 +18361,27 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `role`.
+    # Updates a role. You are allowed to update `name`, `description` and `administrative` attributes after role is
+    # created. Within this endpoint you can't add or remove roles permits you need to use
+    # <<services/permits, service>> that manages permits of role.
+    # 
+    # For example to update role's `name`, `description` and `administrative` attributes send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/roles/123
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <role>
+    #   <name>MyNewRoleName</name>
+    #   <description>My new description of the role</description>
+    #   <administrative>true</administrative>
+    # </group>
+    # ----
     # 
     # @param role [Role] The `role` to update.
     # @param opts [Hash] Additional options.
@@ -17691,7 +18479,30 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `role`.
+    # Create a new role. The role can be administrative or non-administrative and can have different permits.
+    # 
+    # For example, to add the `MyRole` non-administrative role with permits to login and create virtual machines
+    # send a request like this (note that you have to pass permit id):
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/roles
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <role>
+    #   <name>MyRole</name>
+    #   <description>My custom role to create virtual machines</description>
+    #   <administrative>false</administrative>
+    #   <permits>
+    #     <permit id="1"/>
+    #     <permit id="1300"/>
+    #   </permits>
+    # </group>
+    # ----
     # 
     # @param role [Role] The `role` to add.
     # 
@@ -17714,7 +18525,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return RoleReader.read_one(reader)
@@ -17837,7 +18648,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return SchedulingPolicyReader.read_one(reader)
@@ -18351,7 +19162,22 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `restore` method.
+    # Restores a virtual machine snapshot.
+    # 
+    # For example, to restore the snapshot with identifier `456` of virtual machine with identifier `123` send a
+    # request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/snapshots/456/restore
+    # ----
+    # 
+    # With an empty `action` in the body:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -18921,7 +19747,23 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `snapshot`.
+    # Creates a virtual machine snapshot.
+    # 
+    # For example, to create a new snapshot for virtual machine `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/snapshots
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <snapshot>
+    #   <description>My snapshot</description>
+    # </snapshot>
+    # ----
     # 
     # @param snapshot [Snapshot] The `snapshot` to add.
     # 
@@ -18944,7 +19786,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return SnapshotReader.read_one(reader)
@@ -19195,7 +20037,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return SshPublicKeyReader.read_one(reader)
@@ -19586,7 +20428,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return StepReader.read_one(reader)
@@ -19869,13 +20711,37 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `refresh_luns` method.
+    # This operation refreshes the LUN size.
+    # 
+    # After increasing the size of the underlying LUN on the storage server,
+    # the user can refresh the LUN size.
+    # This action forces a rescan of the provided LUNs and
+    # updates the database with the new size if required.
+    # 
+    # For example, in order to refresh the size of two LUNs send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/storagedomains/262b056b-aede-40f1-9666-b883eff59d40/refreshluns
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    #  <action>
+    #    <logical_units>
+    #      <logical_unit id="1IET_00010001"/>
+    #      <logical_unit id="1IET_00010002"/>
+    #    </logical_units>
+    #  </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the refresh should be performed asynchronously.
     # 
-    # @option opts [Array<LogicalUnit>] :logical_units 
+    # @option opts [Array<LogicalUnit>] :logical_units The LUNs that need to be refreshed.
     # 
     def refresh_luns(opts = {})
       action = Action.new(opts)
@@ -19916,9 +20782,19 @@ module OvirtSDK4
     # @option opts [Boolean] :destroy Indicates if the operation should succeed, and the storage domain removed from the database, even if the
     #   storage isn't accessible.
     #   
+    #   [source]
+    #   ----
+    #   DELETE /ovirt-engine/api/storagedomains/123?destroy=true
+    #   ----
+    #   
     #   This parameter is optional, and the default value is `false`.
     # @option opts [Boolean] :format Indicates if the actual storage should be formatted, removing all the metadata from the underlying LUN or
-    #   directory.
+    #   directory:
+    #   
+    #   [source]
+    #   ----
+    #   DELETE /ovirt-engine/api/storagedomains/123?format=true
+    #   ----
     #   
     #   This parameter is optional, and the default value is `false`.
     # @option opts [String] :host Indicates what host should be used to remove the storage domain.
@@ -19959,7 +20835,30 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `storage_domain`.
+    # Updates a storage domain.
+    # 
+    # Not all of the <<types/storage_domain,StorageDomain>>'s attributes are updatable post-creation. Those that can be
+    # updated are: `name`, `description`, `comment`, `warning_low_space_indicator`, `critical_space_action_blocker` and
+    # `wipe_after_delete` (note that changing the `wipe_after_delete` attribute will not change the wipe after delete
+    # property of disks that already exist).
+    # 
+    # To update the `name` and `wipe_after_delete` attributes of a storage domain with an identifier `123`, send a
+    # request as follows:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/storagedomains/123
+    # ----
+    # 
+    # With a request body as follows:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_domain>
+    #   <name>data2</name>
+    #   <wipe_after_delete>true</wipe_after_delete>
+    # </storage_domain>
+    # ----
     # 
     # @param storage_domain [StorageDomain] The `storage_domain` to update.
     # @param opts [Hash] Additional options.
@@ -20068,7 +20967,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `files` service.
+    # Returns a reference to the service that manages the files available in the storage domain.
     # 
     # @return [FilesService] A reference to `files` service.
     def files_service
@@ -20092,7 +20991,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `storage_connections` service.
+    # Returns a reference to the service that manages the storage connections.
     # 
     # @return [StorageDomainServerConnectionsService] A reference to `storage_connections` service.
     def storage_connections_service
@@ -20409,7 +21308,7 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Detaches a storage connection from storage.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20493,7 +21392,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return StorageConnectionReader.read_one(reader)
@@ -20877,11 +21776,69 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `import` method.
-    # 
-    # @param opts [Hash] Additional options.
+    # Imports a virtual machine from an export storage domain.
     # 
-    # @option opts [Boolean] :async Indicates if the import should be performed asynchronously.
+    # For example, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/storagedomains/123/vms/456/import
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain>
+    #     <name>mydata</name>
+    #   </storage_domain>
+    #   <cluster>
+    #     <name>mycluster</name>
+    #   </cluster>
+    # </action>
+    # ----
+    # 
+    # To import a virtual machine as a new entity add the `clone` parameter:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain>
+    #     <name>mydata</name>
+    #   </storage_domain>
+    #   <cluster>
+    #     <name>mycluster</name>
+    #   </cluster>
+    #   <clone>true</clone>
+    #   <vm>
+    #     <name>myvm</name>
+    #   </vm>
+    # </action>
+    # ----
+    # 
+    # Include an optional `disks` parameter to choose which disks to import. For example, to import the disks
+    # of the template that have the identifiers `123` and `456` send the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <cluster>
+    #     <name>mycluster</name>
+    #   </cluster>
+    #   <vm>
+    #     <name>myvm</name>
+    #   </vm>
+    #   <disks>
+    #     <disk id="123"/>
+    #     <disk id="456"/>
+    #   </disks>
+    # </action>
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @option opts [Boolean] :async Indicates if the import should be performed asynchronously.
     # 
     # @option opts [Boolean] :clone Indicates if the identifiers of the imported virtual machine
     #   should be regenerated.
@@ -20898,7 +21855,7 @@ module OvirtSDK4
     #   should be collapsed, so that the result will be a virtual machine
     #   without snapshots.
     #   
-    #   This parameter is optional, and if it isn't explicity specified the
+    #   This parameter is optional, and if it isn't explicitly specified the
     #   default value is `false`.
     # 
     # @option opts [StorageDomain] :storage_domain 
@@ -20959,7 +21916,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Deletes a virtual machine from an export storage domain.
+    # 
+    # For example, to delete the virtual machine `456` from the storage domain `123`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/storagedomains/123/vms/456
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -20978,6 +21942,14 @@ module OvirtSDK4
       end
     end
     
+    # 
+    # Returns a reference to the service that manages the disk attachments of the virtual machine.
+    # 
+    # @return [StorageDomainVmDiskAttachmentsService] A reference to `disk_attachments` service.
+    def disk_attachments_service
+      return StorageDomainVmDiskAttachmentsService.new(@connection, "#{@path}/diskattachments")
+    end
+    
     # 
     # Locates the `disks` service.
     # 
@@ -20997,6 +21969,12 @@ module OvirtSDK4
       if path.nil? || path == ''
         return self
       end
+      if path == 'diskattachments'
+        return disk_attachments_service
+      end
+      if path.start_with?('diskattachments/')
+        return disk_attachments_service.service(path[16..-1])
+      end
       if path == 'disks'
         return disks_service
       end
@@ -21017,6 +21995,151 @@ module OvirtSDK4
     
   end
   
+  class StorageDomainVmDiskAttachmentService < Service
+    
+    # 
+    # Creates a new implementation of the service.
+    # 
+    # @param connection [Connection] The connection to be used by this service.
+    # 
+    # @param path [String] The relative path of this service, for example `vms/123/disks`.
+    # 
+    # @api private
+    # 
+    def initialize(connection, path)
+      @connection = connection
+      @path = path
+    end
+    
+    # 
+    # Returns the details of the attachment with all its properties and a link to the disk.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @return [DiskAttachment]
+    # 
+    def get(opts = {})
+      query = {}
+      request = HttpRequest.new(:method => :GET, :url => @path, :query => query)
+      response = @connection.send(request)
+      case response.code
+      when 200
+        begin
+          reader = XmlReader.new(response.body)
+          return DiskAttachmentReader.read_one(reader)
+        ensure
+          reader.close
+        end
+      else
+        check_fault(response)
+      end
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      raise Error.new("The path \"#{path}\" doesn't correspond to any service")
+    end
+    
+    # 
+    # Returns an string representation of this service.
+    # 
+    # @return [String]
+    # 
+    def to_s
+      return "#<#{StorageDomainVmDiskAttachmentService}:#{@path}>"
+    end
+    
+  end
+  
+  class StorageDomainVmDiskAttachmentsService < Service
+    
+    # 
+    # Creates a new implementation of the service.
+    # 
+    # @param connection [Connection] The connection to be used by this service.
+    # 
+    # @param path [String] The relative path of this service, for example `vms/123/disks`.
+    # 
+    # @api private
+    # 
+    def initialize(connection, path)
+      @connection = connection
+      @path = path
+    end
+    
+    # 
+    # List the disks that are attached to the virtual machine.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @return [Array<DiskAttachment>]
+    # 
+    def list(opts = {})
+      query = {}
+      request = HttpRequest.new(:method => :GET, :url => @path, :query => query)
+      response = @connection.send(request)
+      case response.code
+      when 200
+        begin
+          reader = XmlReader.new(response.body)
+          return DiskAttachmentReader.read_many(reader)
+        ensure
+          reader.close
+        end
+      else
+        check_fault(response)
+      end
+    end
+    
+    # 
+    # Reference to the service that manages a specific attachment.
+    # 
+    # @param id [String] The identifier of the `attachment`.
+    # 
+    # @return [StorageDomainVmDiskAttachmentService] A reference to the `attachment` service.
+    # 
+    def attachment_service(id)
+      return StorageDomainVmDiskAttachmentService.new(@connection, "#{@path}/#{id}")
+    end
+    
+    # 
+    # Locates the service corresponding to the given path.
+    # 
+    # @param path [String] The path of the service.
+    # 
+    # @return [Service] A reference to the service.
+    # 
+    def service(path)
+      if path.nil? || path == ''
+        return self
+      end
+      index = path.index('/')
+      if index.nil?
+        return attachment_service(path)
+      end
+      return attachment_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+    end
+    
+    # 
+    # Returns an string representation of this service.
+    # 
+    # @return [String]
+    # 
+    def to_s
+      return "#<#{StorageDomainVmDiskAttachmentsService}:#{@path}>"
+    end
+    
+  end
+  
   class StorageDomainVmsService < Service
     
     # 
@@ -21122,7 +22245,57 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `storage_domain`.
+    # Adds a new storage domain.
+    # 
+    # Creation of a new <<types/storage_domain,StorageDomain>> requires the `name`, `type`, `host` and `storage`
+    # attributes. Identify the `host` attribute with the `id` or `name` attributes. In oVirt 3.6 and later you can
+    # enable the wipe after delete option by default on the storage domain. To configure this, specify
+    # `wipe_after_delete` in the POST request. This option can be edited after the domain is created, but doing so will
+    # not change the wipe after delete property of disks that already exist.
+    # 
+    # To add a new storage domain with specified `name`, `type`, `storage.type`, `storage.address` and `storage.path`
+    # and by using a host with an id `123`, send a request as follows:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/storagedomains
+    # ----
+    # 
+    # With a request body as follows:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_domain>
+    #   <name>mydata</name>
+    #   <type>data</type>
+    #   <storage>
+    #     <type>nfs</type>
+    #     <address>mynfs.example.com</address>
+    #     <path>/exports/mydata</path>
+    #   </storage>
+    #   <host>
+    #     <name>myhost</name>
+    #   </host>
+    # </storage_domain>
+    # ----
+    # 
+    # To create a new NFS ISO storage domain send a request like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_domain>
+    #   <name>myisos</name>
+    #   <type>iso</type>
+    #   <storage>
+    #     <type>nfs</type>
+    #     <address>mynfs.example.com</address>
+    #     <path>/export/myisos</path>
+    #   </storage>
+    #   <host>
+    #     <name>myhost</name>
+    #   </host>
+    # </storage_domain>
+    # ----
     # 
     # @param storage_domain [StorageDomain] The `storage_domain` to add.
     # 
@@ -21145,7 +22318,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return StorageDomainReader.read_one(reader)
@@ -21291,11 +22464,24 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a storage connection.
+    # 
+    # A storage connection can only be deleted if neither storage domain nor LUN disks reference it. The host name or
+    # id is optional; providing it disconnects (unmounts) the connection from that host.
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
+    # @option opts [String] :host The name or identifier of the host from which the connection would be unmounted (disconnected). If not
+    #   provided, no host will be disconnected.
+    #   
+    #   For example, to use the host with identifier `456` to delete the storage connection with identifier `123`
+    #   send a request like this:
+    #   
+    #   [source]
+    #   ----
+    #   DELETE /ovirt-engine/api/storageconnections/123?host=456
+    #   ----
     def remove(opts = {})
       query = {}
       value = opts[:async]
@@ -21303,6 +22489,10 @@ module OvirtSDK4
         value = Writer.render_boolean(value)
         query['async'] = value
       end
+      value = opts[:host]
+      unless value.nil?
+        query['host'] = value
+      end
       request = HttpRequest.new(:method => :DELETE, :url => @path, :query => query)
       response = @connection.send(request)
       unless response.code == 200
@@ -21311,13 +22501,37 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `connection`.
+    # Updates the storage connection.
+    # 
+    # For example, to change the address of the storage server send a request like this:
+    # 
+    # [source,xml]
+    # ----
+    # PUT /ovirt-engine/api/storageconnections/123
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_connection>
+    #   <address>mynewnfs.example.com</address>
+    #   <host>
+    #     <name>myhost</name>
+    #   </host>
+    # </storage_connection>
+    # ----
     # 
     # @param connection [StorageConnection] The `connection` to update.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
     # 
+    # @option opts [Boolean] :force Indicates if the operation should succeed regardless to the relevant storage domain's status
+    #   (i.e. updating is also applicable when storage domain's status is not maintenance).
+    #   
+    #   This parameter is optional, and the default value is `false`.
+    # 
     # @return [StorageConnection]
     # 
     def update(connection, opts = {})
@@ -21330,6 +22544,11 @@ module OvirtSDK4
         value = Writer.render_boolean(value)
         query['async'] = value
       end
+      value = opts[:force]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['force'] = value
+      end
       request = HttpRequest.new(:method => :PUT, :url => @path, :query => query)
       begin
         writer = XmlWriter.new(nil, true)
@@ -21439,7 +22658,25 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `extension`.
+    # Update a storage server connection extension for the given host.
+    # 
+    # To update the storage connection `456` of host `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/hosts/123/storageconnectionextensions/456
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_connection_extension>
+    #   <target>iqn.2016-01.com.example:mytarget</target>
+    #   <username>myuser</username>
+    #   <password>mypassword</password>
+    # </storage_connection_extension>
+    # ----
     # 
     # @param extension [StorageConnectionExtension] The `extension` to update.
     # @param opts [Hash] Additional options.
@@ -21523,7 +22760,27 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `extension`.
+    # Creates a new storage server connection extension for the given host.
+    # 
+    # The extension lets the user define credentials for an iSCSI target for a specific host. For example to use
+    # `myuser` and `mypassword` as the credentials when connecting to the iSCSI target from host `123` send a request
+    # like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts/123/storageconnectionextensions
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_connection_extension>
+    #   <target>iqn.2016-01.com.example:mytarget</target>
+    #   <username>myuser</username>
+    #   <password>mypassword</password>
+    # </storage_connection_extension>
+    # ----
     # 
     # @param extension [StorageConnectionExtension] The `extension` to add.
     # 
@@ -21546,7 +22803,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return StorageConnectionExtensionReader.read_one(reader)
@@ -21646,7 +22903,29 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `connection`.
+    # Creates a new storage connection.
+    # 
+    # For example, to create a new storage connection for the NFS server `mynfs.example.com` and NFS share
+    # `/export/mydata` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/storageconnections
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <storage_connection>
+    #   <type>nfs</type>
+    #   <address>mynfs.example.com</address>
+    #   <path>/export/mydata</path>
+    #   <host>
+    #     <name>myhost</name>
+    #   </host>
+    # </storage_connection>
+    # ----
     # 
     # @param connection [StorageConnection] The `connection` to add.
     # 
@@ -21669,7 +22948,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return StorageConnectionReader.read_one(reader)
@@ -21772,6 +23051,83 @@ module OvirtSDK4
     # Returns basic information describing the API, like the product name, the version number and a summary of the
     # number of relevant objects.
     # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api
+    # ----
+    # 
+    # We get following response:
+    # 
+    # [source,xml]
+    # ----
+    # <api>
+    #   <link rel="capabilities" href="/api/capabilities"/>
+    #   <link rel="clusters" href="/api/clusters"/>
+    #   <link rel="clusters/search" href="/api/clusters?search={query}"/>
+    #   <link rel="datacenters" href="/api/datacenters"/>
+    #   <link rel="datacenters/search" href="/api/datacenters?search={query}"/>
+    #   <link rel="events" href="/api/events"/>
+    #   <link rel="events/search" href="/api/events?search={query}"/>
+    #   <link rel="hosts" href="/api/hosts"/>
+    #   <link rel="hosts/search" href="/api/hosts?search={query}"/>
+    #   <link rel="networks" href="/api/networks"/>
+    #   <link rel="roles" href="/api/roles"/>
+    #   <link rel="storagedomains" href="/api/storagedomains"/>
+    #   <link rel="storagedomains/search" href="/api/storagedomains?search={query}"/>
+    #   <link rel="tags" href="/api/tags"/>
+    #   <link rel="templates" href="/api/templates"/>
+    #   <link rel="templates/search" href="/api/templates?search={query}"/>
+    #   <link rel="users" href="/api/users"/>
+    #   <link rel="groups" href="/api/groups"/>
+    #   <link rel="domains" href="/api/domains"/>
+    #   <link rel="vmpools" href="/api/vmpools"/>
+    #   <link rel="vmpools/search" href="/api/vmpools?search={query}"/>
+    #   <link rel="vms" href="/api/vms"/>
+    #   <link rel="vms/search" href="/api/vms?search={query}"/>
+    #   <product_info>
+    #     <name>oVirt Engine</name>
+    #     <vendor>ovirt.org</vendor>
+    #     <version>
+    #       <build>4</build>
+    #       <full_version>4.0.4</full_version>
+    #       <major>4</major>
+    #       <minor>0</minor>
+    #       <revision>0</revision>
+    #     </version>
+    #   </product_info>
+    #   <special_objects>
+    #     <blank_template href="/ovirt-engine/api/templates/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000"/>
+    #     <root_tag href="/ovirt-engine/api/tags/00000000-0000-0000-0000-000000000000" id="00000000-0000-0000-0000-000000000000"/>
+    #   </special_objects>
+    #   <summary>
+    #     <hosts>
+    #       <active>0</active>
+    #       <total>0</total>
+    #     </hosts>
+    #     <storage_domains>
+    #       <active>0</active>
+    #       <total>1</total>
+    #     </storage_domains>
+    #     <users>
+    #       <active>1</active>
+    #       <total>1</total>
+    #     </users>
+    #     <vms>
+    #       <active>0</active>
+    #       <total>0</total>
+    #     </vms>
+    #   </summary>
+    #   <time>2016-09-14T12:00:48.132+02:00</time>
+    # </api>
+    # ----
+    # 
+    # The entry point provides a user with links to the collections in a
+    # virtualization environment. The `rel` attribute of each collection link
+    # provides a reference point for each link.
+    # 
+    # The entry point also contains other data such as `product_info`,
+    # `special_objects` and `summary`.
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @return [Api]
@@ -22418,7 +23774,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return PermissionReader.read_one(reader)
@@ -22663,7 +24019,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return TagReader.read_one(reader)
@@ -22763,13 +24119,33 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `export` method.
+    # Exports a template to the data center export domain.
+    # 
+    # For example, the operation can be facilitated using the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/templates/123/export
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain id="456"/>
+    #   <exclusive>true<exclusive/>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :exclussive 
+    # @option opts [Boolean] :exclusive Indicates if the existing templates with the same name should be overwritten.
+    #   
+    #   The export action reports a failed action if a template of the same name exists in the destination domain.
+    #   Set this parameter to `true` to change this behavior and overwrite any existing template.
     # 
-    # @option opts [StorageDomain] :storage_domain 
+    # @option opts [StorageDomain] :storage_domain Specifies the destination export storage domain.
     # 
     def export(opts = {})
       action = Action.new(opts)
@@ -22823,7 +24199,12 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removas a virtual machine template.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/templates/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -22843,7 +24224,38 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `template`.
+    # Updates the template.
+    # 
+    # The `name`, `description`, `type`, `memory`, `cpu`, `topology`, `os`, `high_availability`, `display`,
+    # `stateless`, `usb` and `timezone` elements can be updated after a template has been created.
+    # 
+    # For example, to update a template to so that it has 1 GiB of memory send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/templates/123
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <template>
+    #   <memory>1073741824</memory>
+    # </template>
+    # ----
+    # 
+    # The `version_name` name attribute is the only one that can be updated within the `version` attribute used for
+    # template versions:
+    # 
+    # [source,xml]
+    # ----
+    # <template>
+    #   <version>
+    #     <version_name>mytemplate_2</version_name>
+    #   </version>
+    # </template>
+    # ----
     # 
     # @param template [Template] The `template` to update.
     # @param opts [Hash] Additional options.
@@ -23738,7 +25150,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NicReader.read_one(reader)
@@ -23989,7 +25401,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return WatchdogReader.read_one(reader)
@@ -24089,7 +25501,41 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `template`.
+    # Creates a new template.
+    # 
+    # This requires the `name` and `vm` elements. Identify the virtual machine with the `id` `name` attributes.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/templates
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <template>
+    #   <name>mytemplate</name>
+    #   <vm id="123"/>
+    # </template>
+    # ----
+    # 
+    # The template can be created as a sub version of an existing template.This requires the `name` and `vm` attributes
+    # for the new template, and the `base_template` and `version_name` attributes for the new template version. The
+    # `base_template` and `version_name` attributes must be specified within a `version` section enclosed in the
+    # `template` section. Identify the virtual machine with the `id` or `name` attributes.
+    # 
+    # [source,xml]
+    # ----
+    # <template>
+    #   <name>mytemplate</name>
+    #   <vm id="123"/>
+    #   <version>
+    #     <base_template id="456"/>
+    #     <version_name>mytemplate_001</version_name>
+    #   </version>
+    # </template>
+    # ----
     # 
     # @param template [Template] The `template` to add.
     # 
@@ -24140,7 +25586,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return TemplateReader.read_one(reader)
@@ -24575,7 +26021,45 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `user`.
+    # Add user from a directory service.
+    # 
+    # For example, to add the `myuser` user from the `myextension-authz` authorization provider send a request
+    # like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/users
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <user>
+    #   <user_name>myuser@myextension-authz</user_name>
+    #   <domain>
+    #     <name>myextension-authz</name>
+    #   </domain>
+    # </user>
+    # ----
+    # 
+    # In case you are working with Active Directory you have to pass user principal name (UPN) as `username`, followed
+    # by authorization provider name. Due to https://bugzilla.redhat.com/1147900[bug 1147900] you need to provide
+    # also `principal` parameter set to UPN of the user.
+    # 
+    # For example, to add the user with UPN `myuser@mysubdomain.mydomain.com` from the `myextension-authz`
+    # authorization provider send a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <user>
+    #   <principal>myuser@mysubdomain.mydomain.com</principal>
+    #   <user_name>myuser@mysubdomain.mydomain.com@myextension-authz</user_name>
+    #   <domain>
+    #     <name>myextension-authz</name>
+    #   </domain>
+    # </user>
+    # ----
     # 
     # @param user [User] The `user` to add.
     # 
@@ -24598,7 +26082,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return UserReader.read_one(reader)
@@ -24821,7 +26305,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NetworkReader.read_one(reader)
@@ -24921,7 +26405,20 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `cancel_migration` method.
+    # This operation stops any migration of a virtual machine to another physical host.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/cancelmigration
+    # ----
+    # 
+    # The cancel migration action does not take any action specific parameters,
+    # so the request body should contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25004,7 +26501,20 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `detach` method.
+    # Detaches a virtual machine from a pool.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/detach
+    # ----
+    # 
+    # The detach action does not take any action specific parameters, so the request body should contain an
+    # empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25031,15 +26541,37 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `export` method.
+    # Export a virtual machine to an export domain.
+    # 
+    # For example to export virtual machine `123` to the export domain `myexport`, send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/export
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain>
+    #     <name>myexport</name>
+    #   </storage_domain>
+    #   <exclusive>true</exclusive>
+    #   <discard_snapshots>true</discard_snapshots>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the export should be performed asynchronously.
     # 
-    # @option opts [Boolean] :discard_snapshots 
+    # @option opts [Boolean] :discard_snapshots The `discard_snapshots` parameter is to be used when the virtual machine should be exported with all its
+    #   snapshots collapsed.
     # 
-    # @option opts [Boolean] :exclusive 
+    # @option opts [Boolean] :exclusive The `exclusive` parameter is to be used when the virtual machine should be exported even if another copy of
+    #   it already exists in the export domain (override).
     # 
     # @option opts [StorageDomain] :storage_domain 
     # 
@@ -25064,7 +26596,23 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `freeze_filesystems` method.
+    # Freeze virtual machine file systems.
+    # 
+    # This operation freezes a virtual machine's file systems using the QEMU guest agent when taking a live snapshot of
+    # a running virtual machine. Normally, this is done automatically by the manager, but this must be executed
+    # manually with the API for virtual machines using OpenStack Volume (Cinder) disks.
+    # 
+    # Example:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/freezefilesystems
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25093,29 +26641,27 @@ module OvirtSDK4
     # 
     # Retrieves the description of the virtual machine.
     # 
-    # Note that some elements of the description of the virtual machine won't be returned unless the `All-Content`
-    # header is present in the request and has the value `true`. The elements that aren't currently returned are
-    # the following:
-    # 
-    # - `console`
-    # - `initialization.configuration.data` - The OVF document describing the virtual machine.
-    # - `rng_source`
-    # - `soundcard`
-    # - `virtio_scsi`
-    # 
-    # With the Python SDK the `All-Content` header can be set using the `all_content` parameter of the `get`
-    # method:
-    # 
-    # [source,python]
-    # ----
-    # api.vms.get(name="myvm", all_content=True)
-    # ----
-    # 
-    # Note that the reason for not including these elements is performance: they are seldom used and they require
-    # additional queries in the server. So try to use the `All-Content` header only when it is really needed.
-    # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :all_content Indicates if all the attributes of the virtual machine should be included in the response.
+    #   
+    #   By default the following attributes are excluded:
+    #   
+    #   - `console`
+    #   - `initialization.configuration.data` - The OVF document describing the virtual machine.
+    #   - `rng_source`
+    #   - `soundcard`
+    #   - `virtio_scsi`
+    #   
+    #   For example, to retrieve the complete representation of the virtual machine '123' send a request like this:
+    #   
+    #   ....
+    #   GET /ovirt-engine/api/vms/123?all_content=true
+    #   ....
+    #   
+    #   NOTE: The reason for not including these attributes is performance: they are seldom used and they require
+    #   additional queries to the database. So try to use the this parameter only when it is really needed.
+    # 
     # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
     # 
     # @option opts [Boolean] :next_run Indicates if the returned result describes the virtual machine as it is currently running, or if describes
@@ -25141,6 +26687,11 @@ module OvirtSDK4
     # 
     def get(opts = {})
       query = {}
+      value = opts[:all_content]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['all_content'] = value
+      end
       value = opts[:filter]
       unless value.nil?
         value = Writer.render_boolean(value)
@@ -25167,7 +26718,27 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `logon` method.
+    # Initiates the automatic user logon to access a virtual machine from an external console.
+    # 
+    # This action requires the `ovirt-guest-agent-gdm-plugin` and the `ovirt-guest-agent-pam-module` packages to be
+    # installed and the `ovirt-guest-agent` service to be running on the virtual machine.
+    # 
+    # Users require the appropriate user permissions for the virtual machine in order to access the virtual machine
+    # from an external console.
+    # 
+    # This is how an example request would look like:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/logon
+    # ----
+    # 
+    # Request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25223,17 +26794,35 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `migrate` method.
+    # This operation migrates a virtual machine to another physical host.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/migrate
+    # ----
+    # 
+    # One can specify a specific host to migrate the virtual machine to:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <host id="2ab5e1da-b726-4274-bbf7-0a42b16a0fc3"/>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the migration should be performed asynchronously.
     # 
-    # @option opts [Cluster] :cluster 
+    # @option opts [Cluster] :cluster Specifies the cluster the virtual machine should migrate to. This is an optional parameter. By default, the
+    #   virtual machine is migrated to another host within the same cluster.
     # 
-    # @option opts [Boolean] :force 
+    # @option opts [Boolean] :force Specifies the virtual machine should migrate although it might be defined as non migratable. This is an
+    #   optional parameter. By default, it is set to `false`.
     # 
-    # @option opts [Host] :host 
+    # @option opts [Host] :host Specifies a specific host the virtual machine should migrate to. This is an optional parameters. By default,
+    #   the oVirt Engine automatically selects a default host for migration within the same cluster. If an API user
+    #   requires a specific host, the user can specify the host with either an `id` or `name` parameter.
     # 
     def migrate(opts = {})
       action = Action.new(opts)
@@ -25291,7 +26880,20 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `reboot` method.
+    # This operation sends a reboot request to a virtual machine.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/reboot
+    # ----
+    # 
+    # The reboot action does not take any action specific parameters, so the request body should contain an
+    # empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25318,11 +26920,23 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the virtual machine, including the virtual disks attached to it.
+    # 
+    # For example, to remove the virtual machine with identifier `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vms/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
+    # @option opts [Boolean] :detach_only Indicates if the attached virtual disks should be detached first and preserved instead of being removed.
+    # @option opts [Boolean] :force Indicates if the virtual machine should be forcibly removed.
+    #   
+    #   Locked virtual machines and virtual machines with locked disk images
+    #   cannot be removed without this flag set to true.
     def remove(opts = {})
       query = {}
       value = opts[:async]
@@ -25330,6 +26944,16 @@ module OvirtSDK4
         value = Writer.render_boolean(value)
         query['async'] = value
       end
+      value = opts[:detach_only]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['detach_only'] = value
+      end
+      value = opts[:force]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['force'] = value
+      end
       request = HttpRequest.new(:method => :DELETE, :url => @path, :query => query)
       response = @connection.send(request)
       unless response.code == 200
@@ -25365,7 +26989,20 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `shutdown` method.
+    # This operation sends a shutdown request to a virtual machine.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/shutdown
+    # ----
+    # 
+    # The shutdown action does not take any action specific parameters,
+    # so the request body should contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25392,7 +27029,24 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `start` method.
+    # Starts the virtual machine.
+    # 
+    # If the virtual environment is complete and the virtual machine contains all necessary components to function,
+    # it can be started.
+    # 
+    # This example starts the virtual machine:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/start
+    # ----
+    # 
+    # With a request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25400,13 +27054,35 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :filter Indicates if the results should be filtered according to the permissions of the user.
     # 
-    # @option opts [Boolean] :pause 
+    # @option opts [Boolean] :pause If set to `true`, start the virtual machine in paused mode. Default is `false`.
     # 
-    # @option opts [Boolean] :use_cloud_init 
+    # @option opts [Boolean] :use_cloud_init If set to `true`, the initialization type is set to _cloud-init_. The default value is `false`.
+    #   See https://cloudinit.readthedocs.io/en/latest[this] for details.
     # 
-    # @option opts [Boolean] :use_sysprep 
+    # @option opts [Boolean] :use_sysprep If set to `true`, the initialization type is set to _Sysprep_. The default value is `false`.
+    #   See https://en.wikipedia.org/wiki/Sysprep[this] for details.
     # 
-    # @option opts [Vm] :vm 
+    # @option opts [Vm] :vm The definition of the virtual machine for this specific run.
+    #   
+    #   For example:
+    #   
+    #   [source,xml]
+    #   ----
+    #   <action>
+    #     <vm>
+    #       <os>
+    #         <boot>
+    #           <devices>
+    #             <device>cdrom</device>
+    #           </devices>
+    #         </boot>
+    #       </os>
+    #     </vm>
+    #   </action>
+    #   ----
+    #   
+    #   This will set the boot device to the CDROM only for this specific start. After the virtual machine will be
+    #   powered off, this definition will be reverted.
     # 
     def start(opts = {})
       action = Action.new(opts)
@@ -25429,7 +27105,20 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `stop` method.
+    # This operation forces a virtual machine to power-off.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/stop
+    # ----
+    # 
+    # The stop action does not take any action specific parameters,
+    # so the request body should contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25456,7 +27145,21 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `suspend` method.
+    # This operation saves the virtual machine state to disk and stops it.
+    # Start a suspended virtual machine and restore the virtual machine state with the start action.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/suspend
+    # ----
+    # 
+    # The suspend action does not take any action specific parameters,
+    # so the request body should contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25483,7 +27186,23 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `thaw_filesystems` method.
+    # Thaw virtual machine file systems.
+    # 
+    # This operation thaws a virtual machine's file systems using the QEMU guest agent when taking a live snapshot of a
+    # running virtual machine. Normally, this is done automatically by the manager, but this must be executed manually
+    # with the API for virtual machines using OpenStack Volume (Cinder) disks.
+    # 
+    # Example:
+    # 
+    # [source]
+    # ----
+    # POST /api/vms/123/thawfilesystems
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25510,7 +27229,26 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `ticket` method.
+    # Generates a time-sensitive authentication token for accessing a virtual machine's display.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/ticket
+    # ----
+    # 
+    # The client-provided action optionally includes a desired ticket value and/or an expiry time in seconds.
+    # 
+    # In any case, the response specifies the actual ticket value and expiry used.
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <ticket>
+    #     <value>abcd12345</value>
+    #     <expiry>120</expiry>
+    #   </ticket>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25574,6 +27312,10 @@ module OvirtSDK4
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
     # 
+    # @option opts [Boolean] :next_run Indicates if the update should be applied to the virtual machine immediately, or if it should be applied only
+    #   when the virtual machine is restarted. The default value is `false`, so by default changes are applied
+    #   immediately.
+    # 
     # @return [Vm]
     # 
     def update(vm, opts = {})
@@ -25586,6 +27328,11 @@ module OvirtSDK4
         value = Writer.render_boolean(value)
         query['async'] = value
       end
+      value = opts[:next_run]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['next_run'] = value
+      end
       request = HttpRequest.new(:method => :PUT, :url => @path, :query => query)
       begin
         writer = XmlWriter.new(nil, true)
@@ -25698,7 +27445,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `sessions` service.
+    # Reference to the service that provides information about virtual machine user sessions.
     # 
     # @return [VmSessionsService] A reference to `sessions` service.
     def sessions_service
@@ -26541,7 +28288,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return DiskReader.read_one(reader)
@@ -26878,7 +28625,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return HostDeviceReader.read_one(reader)
@@ -27056,7 +28803,25 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes the NIC.
+    # 
+    # For example, to remove the NIC with id `456` from the virtual machine with id `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vms/123/nics/456
+    # ----
+    # 
+    # [IMPORTANT]
+    # ====
+    # The hotplugging feature only supports virtual machine operating systems with hotplugging operations.
+    # Example operating systems include:
+    # 
+    # - Red Hat Enterprise Linux 6
+    # - Red Hat Enterprise Linux 5
+    # - Windows Server 2008 and
+    # - Windows Server 2003
+    # ====
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27076,7 +28841,36 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `nic`.
+    # Updates the NIC.
+    # 
+    # For example, to update the NIC having with `456` belonging to virtual the machine with id `123` send a request
+    # like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vms/123/nics/456
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <nic>
+    #   <name>mynic</name>
+    #   <interface>e1000</interface>
+    # </nic>
+    # ----
+    # 
+    # [IMPORTANT]
+    # ====
+    # The hotplugging feature only supports virtual machine operating systems with hotplugging operations.
+    # Example operating systems include:
+    # 
+    # - Red Hat Enterprise Linux 6
+    # - Red Hat Enterprise Linux 5
+    # - Windows Server 2008 and
+    # - Windows Server 2003
+    # ====
     # 
     # @param nic [Nic] The `nic` to update.
     # @param opts [Hash] Additional options.
@@ -27188,7 +28982,59 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `nic`.
+    # Adds a NIC to the virtual machine.
+    # 
+    # The following example adds a network interface named `mynic` using `virtio` and the `ovirtmgmt` network to the
+    # virtual machine.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/123/nics
+    # ----
+    # 
+    # [source,xml]
+    # ----
+    # <nic>
+    #   <interface>virtio</interface>
+    #   <name>mynic</name>
+    #   <network>
+    #     <name>ovirtmgmt</name>
+    #   </network>
+    # </nic>
+    # ----
+    # 
+    # The following example sends that request using `curl`:
+    # 
+    # [source,bash]
+    # ----
+    # curl \
+    # --request POST \
+    # --header "Version: 4" \
+    # --header "Content-Type: application/xml" \
+    # --header "Accept: application/xml" \
+    # --user "admin@internal:mypassword" \
+    # --cacert /etc/pki/ovirt-engine/ca.pem \
+    # --data '
+    # <nic>
+    #   <name>mynic</name>
+    #   <network>
+    #     <name>ovirtmgmt</name>
+    #   </network>
+    # </nic>
+    # ' \
+    # https://myengine.example.com/ovirt-engine/api/vms/123/nics
+    # ----
+    # 
+    # [IMPORTANT]
+    # ====
+    # The hotplugging feature only supports virtual machine operating systems with hotplugging operations.
+    # Example operating systems include:
+    # 
+    # - Red Hat Enterprise Linux 6
+    # - Red Hat Enterprise Linux 5
+    # - Windows Server 2008 and
+    # - Windows Server 2003
+    # ====
     # 
     # @param nic [Nic] The `nic` to add.
     # 
@@ -27211,7 +29057,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return NicReader.read_one(reader)
@@ -27335,7 +29181,14 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a virtual NUMA node.
+    # 
+    # An example of removing a virtual NUMA node:
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vms/123/numanodes/456
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27355,7 +29208,29 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `node`.
+    # Updates a virtual NUMA node.
+    # 
+    # An example of pinning a virtual NUMA node to a physical NUMA node on the host:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vms/123/numanodes/456
+    # ----
+    # 
+    # The request body should contain the following:
+    # 
+    # [source,xml]
+    # ----
+    # <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>
+    # ----
     # 
     # @param node [VirtualNumaNode] The `node` to update.
     # @param opts [Hash] Additional options.
@@ -27439,7 +29314,31 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `node`.
+    # Creates a new virtual NUMA node for the virtual machine.
+    # 
+    # An example of creating a NUMA node:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vms/c7ecd2dc/numanodes
+    # Accept: application/xml
+    # Content-type: application/xml
+    # ----
+    # The request body can contain the following:
+    # [source,xml]
+    # ----
+    # <vm_numa_node>
+    #   <cpu>
+    #     <cores>
+    #       <core>
+    #         <index>0</index>
+    #       </core>
+    #     </cores>
+    #   </cpu>
+    #   <index>0</index>
+    #   <memory>1024</memory>
+    # </vm_numa_node>
+    # ----
     # 
     # @param node [VirtualNumaNode] The `node` to add.
     # 
@@ -27462,7 +29361,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VirtualNumaNodeReader.read_one(reader)
@@ -27475,7 +29374,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists virtual NUMA nodes of a virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27562,7 +29461,20 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `allocate_vm` method.
+    # This operation allocates a virtual machine in the virtual machine pool.
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vmpools/123/allocatevm
+    # ----
+    # 
+    # The allocate virtual machine action does not take any action specific parameters, so the request body should
+    # contain an empty `action`:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27620,7 +29532,12 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Removes a virtual machine pool.
+    # 
+    # [source]
+    # ----
+    # DELETE /ovirt-engine/api/vmpools/123
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -27640,9 +29557,29 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `pool`.
+    # Update the virtual machine pool.
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/vmpools/123
+    # ----
+    # 
+    # The `name`, `description`, `size`, `prestarted_vms` and `max_user_vms`
+    # attributes can be updated after the virtual machine pool has been
+    # created.
+    # 
+    # [source,xml]
+    # ----
+    # <vmpool>
+    #   <name>VM_Pool_B</name>
+    #   <description>Virtual Machine Pool B</description>
+    #   <size>3</size>
+    #   <prestarted_vms>1</size>
+    #   <max_user_vms>2</size>
+    # </vmpool>
+    # ----
     # 
-    # @param pool [VmPool] The `pool` to update.
+    # @param pool [VmPool] The virtual machine pool that is being updated.
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
@@ -27738,7 +29675,26 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `pool`.
+    # Creates a new virtual machine pool.
+    # 
+    # A new pool requires the `name`, `cluster` and `template` attributes. Identify the cluster and template with the
+    # `id` or `name` nested attributes:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/vmpools
+    # ----
+    # 
+    # With the following body:
+    # 
+    # [source,xml]
+    # ----
+    # <vmpool>
+    #   <name>mypool</name>
+    #   <cluster id="123"/>
+    #   <template id="456"/>
+    # </vmpool>
+    # ----
     # 
     # @param pool [VmPool] The `pool` to add.
     # 
@@ -27761,7 +29717,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VmPoolReader.read_one(reader)
@@ -28100,7 +30056,31 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Lists all user sessions for this virtual machine.
+    # 
+    # For example, to retrieve the session information for virtual machine `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # GET /ovirt-engine/api/vms/123/sessions
+    # ----
+    # 
+    # The response body will contain something like this:
+    # 
+    # [source,xml]
+    # ----
+    # <sessions>
+    #   <session href="/ovirt-engine/api/vms/123/sessions/456" id="456">
+    #     <console_user>true</console_user>
+    #     <ip>
+    #       <address>192.168.122.1</address>
+    #     </ip>
+    #     <user href="/ovirt-engine/api/users/789" id="789"/>
+    #     <vm href="/ovirt-engine/api/vms/123" id="123"/>
+    #   </session>
+    #   ...
+    # </sessions>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -28131,7 +30111,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `session` service.
+    # Reference to the service that manages a specific session.
     # 
     # @param id [String] The identifier of the `session`.
     # 
@@ -28338,7 +30318,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return WatchdogReader.read_one(reader)
@@ -28545,6 +30525,51 @@ module OvirtSDK4
     # </vm>
     # ----
     # 
+    # It is possible to specify additional virtual machine parameters in the XML description, e.g. a virtual machine
+    # of `desktop` type, with 2 GiB of RAM and additional description can be added sending a request body like the
+    # following:
+    # 
+    # [source,xml]
+    # ----
+    # <vm>
+    #   <name>myvm</name>
+    #   <description>My Desktop Virtual Machine</description>
+    #   <type>desktop</type>
+    #   <memory>2147483648</memory>
+    #   ...
+    # </vm>
+    # ----
+    # 
+    # A bootable CDROM device can be set like this:
+    # 
+    # [source,xml]
+    # ----
+    # <vm>
+    #   ...
+    #   <os>
+    #     <boot dev="cdrom"/>
+    #   </os>
+    # </vm>
+    # ----
+    # 
+    # In order to boot from CDROM, you first need to insert a disk, as described in the
+    # <<services/vm_cdrom, CDROM service>>. Then booting from that CDROM can be specified using the `os.boot.devices`
+    # attribute:
+    # 
+    # [source,xml]
+    # ----
+    # <vm>
+    #   ...
+    #   <os>
+    #     <boot>
+    #       <devices>
+    #         <device>cdrom</device>
+    #       </devices>
+    #     </boot>
+    #   </os>
+    # </vm>
+    # ----
+    # 
     # In all cases the name or identifier of the cluster where the virtual machine will be created is mandatory.
     # 
     # @param vm [Vm] The `vm` to add.
@@ -28635,7 +30660,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VmReader.read_one(reader)
@@ -28652,6 +30677,25 @@ module OvirtSDK4
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :all_content Indicates if all the attributes of the virtual machines should be included in the response.
+    #   
+    #   By default the following attributes are excluded:
+    #   
+    #   - `console`
+    #   - `initialization.configuration.data` - The OVF document describing the virtual machine.
+    #   - `rng_source`
+    #   - `soundcard`
+    #   - `virtio_scsi`
+    #   
+    #   For example, to retrieve the complete representation of the virtual machines send a request like this:
+    #   
+    #   ....
+    #   GET /ovirt-engine/api/vms?all_content=true
+    #   ....
+    #   
+    #   NOTE: The reason for not including these attributes is performance: they are seldom used and they require
+    #   additional queries to the database. So try to use the this parameter only when it is really needed.
+    # 
     # @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`.
@@ -28666,6 +30710,11 @@ module OvirtSDK4
     # 
     def list(opts = {})
       query = {}
+      value = opts[:all_content]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['all_content'] = value
+      end
       value = opts[:case_sensitive]
       unless value.nil?
         value = Writer.render_boolean(value)
@@ -28922,7 +30971,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return VnicProfileReader.read_one(reader)
@@ -29137,7 +31186,7 @@ module OvirtSDK4
       end
       response = @connection.send(request)
       case response.code
-      when 201, 202
+      when 200, 201, 202
         begin
           reader = XmlReader.new(response.body)
           return WeightReader.read_one(reader)
@@ -29244,7 +31293,26 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `copy` method.
+    # This operation copies a disk to the specified storage domain.
+    # 
+    # For example, copy of a disk can be facilitated using the following request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/disks/123/copy
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain id="456"/>
+    #   <disk>
+    #     <name>mydisk</name>
+    #   </disk>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -29332,7 +31400,24 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `move` method.
+    # Moves a disk to another storage domain.
+    # 
+    # For example, to move the disk with identifier `123` to a storage domain with identifier `456` send the following
+    # request:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/disks/123/move
+    # ----
+    # 
+    # With the following request body:
+    # 
+    # [source,xml]
+    # ----
+    # <action>
+    #   <storage_domain id="456"/>
+    # </action>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30317,7 +32402,7 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `activate` method.
+    # Activate the host for use, such as running virtual machines.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30344,7 +32429,9 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `approve` method.
+    # Approve a pre-installed Hypervisor host for usage in the virtualization environment.
+    # 
+    # This action also accepts an optional cluster element to define the target cluster for this host.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30375,6 +32462,27 @@ module OvirtSDK4
     # 
     # Marks the network configuration as good and persists it inside the host.
     # 
+    # An API user commits the network configuration to persist a host network interface attachment or detachment, or
+    # persist the creation and deletion of a bonded interface.
+    # 
+    # IMPORTANT: Networking configuration is only committed after the engine has established that host connectivity is
+    # not lost as a result of the configuration changes. If host connectivity is lost, the host requires a reboot and
+    # automatically reverts to the previous networking configuration.
+    # 
+    # For example, to commit the network configuration of host with id `123` send a request like this:
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts/123/commitnetconfig
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
+    # 
     # @param opts [Hash] Additional options.
     # 
     # @option opts [Boolean] :async Indicates if the action should be performed asynchronously.
@@ -30400,7 +32508,7 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `deactivate` method.
+    # Deactivate the host to perform maintenance tasks.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30432,7 +32540,7 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `enroll_certificate` method.
+    # Enroll certificate of the host. Useful in case you get a warning that it is about to, or already expired.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30459,7 +32567,33 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `fence` method.
+    # Controls host's power management device.
+    # 
+    # For example, let's assume you want to start the host. This can be done via:
+    # 
+    # [source]
+    # ----
+    # #!/bin/sh -ex
+    # 
+    # url="https://engine.example.com/ovirt-engine/api"
+    # user="admin@internal"
+    # password="..."
+    # 
+    # curl \
+    # --verbose \
+    # --cacert /etc/pki/ovirt-engine/ca.pem \
+    # --user "${user}:${password}" \
+    # --request POST \
+    # --header "Version: 4" \
+    # --header "Content-Type: application/xml" \
+    # --header "Accept: application/xml" \
+    # --data '
+    # <action>
+    #   <fence_type>start</fence_type>
+    # </action>
+    # ' \
+    # "${url}/hosts/123/fence"
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30491,7 +32625,19 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `force_select_spm` method.
+    # Manually set a host as the storage pool manager (SPM).
+    # 
+    # [source]
+    # ----
+    # POST /ovirt-engine/api/hosts/123/forceselectspm
+    # ----
+    # 
+    # With a request body like this:
+    # 
+    # [source,xml]
+    # ----
+    # <action/>
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30518,7 +32664,7 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Get the host details.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30549,7 +32695,48 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `install` method.
+    # Install VDSM and related software on the host. The host type defines additional parameters for the action.
+    # 
+    # Example of installing a host, using `curl` and JSON, plain:
+    # 
+    # [source,bash]
+    # ----
+    # curl \
+    # --verbose \
+    # --cacert /etc/pki/ovirt-engine/ca.pem \
+    # --request PUT \
+    # --header "Content-Type: application/json" \
+    # --header "Accept: application/json" \
+    # --header "Version: 4" \
+    # --user "admin@internal:..." \
+    # --data '
+    # {
+    #   "root_password": "myrootpassword"
+    # }
+    # ' \
+    # "https://engine.example.com/ovirt-engine/api/hosts/123"
+    # ----
+    # 
+    # Example of installing a host, using `curl` and JSON, with hosted engine components:
+    # 
+    # [source,bash]
+    # ----
+    # curl \
+    # curl \
+    # --verbose \
+    # --cacert /etc/pki/ovirt-engine/ca.pem \
+    # --request PUT \
+    # --header "Content-Type: application/json" \
+    # --header "Accept: application/json" \
+    # --header "Version: 4" \
+    # --user "admin@internal:..." \
+    # --data '
+    # {
+    #   "root_password": "myrootpassword"
+    # }
+    # ' \
+    # "https://engine.example.com/ovirt-engine/api/hosts/123?deploy_hosted_engine=true"
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30684,7 +32871,24 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Remove the host from the system.
+    # 
+    # [source]
+    # ----
+    # #!/bin/sh -ex
+    # 
+    # url="https://engine.example.com/ovirt-engine/api"
+    # user="admin@internal"
+    # password="..."
+    # 
+    # curl \
+    # --verbose \
+    # --cacert /etc/pki/ovirt-engine/ca.pem \
+    # --user "${user}:${password}" \
+    # --request DELETE \
+    # --header "Version: 4" \
+    # "${url}/hosts/1ff7a191-2f3b-4eff-812b-9f91a30c3acc"
+    # ----
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30838,7 +33042,7 @@ module OvirtSDK4
     # ----
     # 
     # IMPORTANT: To make sure that the network configuration has been saved in the host, and that it will be applied
-    # when the host is rebooted, remember to call <<services/host/methods/commitnetconfig, commitnetconfig>>.
+    # when the host is rebooted, remember to call <<services/host/methods/commit_net_config, commitnetconfig>>.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -30915,7 +33119,25 @@ module OvirtSDK4
     end
     
     # 
-    # Updates the `host`.
+    # Update the host properties.
+    # 
+    # For example, to update a the kernel command line of a host send a request like this:
+    # 
+    # [source]
+    # ----
+    # PUT /ovirt-engine/api/hosts/123
+    # ----
+    # 
+    # With request body like this:
+    # 
+    # [source, xml]
+    # ----
+    # <host>
+    #   <os>
+    #     <custom_kernel_cmdline>vfio_iommu_type1.allow_unsafe_interrupts=1</custom_kernel_cmdline>
+    #   </os>
+    # </host>
+    # ----
     # 
     # @param host [Host] The `host` to update.
     # @param opts [Hash] Additional options.
@@ -30958,7 +33180,7 @@ module OvirtSDK4
     end
     
     # 
-    # Executes the `upgrade` method.
+    # Upgrade VDSM and selected software on the host.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -31033,7 +33255,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `nics` service.
+    # Reference to the service that manages the network interface devices on the host.
     # 
     # @return [HostNicsService] A reference to `nics` service.
     def nics_service