ovirt-engine-sdk 4.0.0 → 4.0.1

data/lib/ovirtsdk4/service.rb

@@ -55,7 +55,7 @@ module OvirtSDK4
     end
 
     #
-    # Reads the response body assuming that it contains a fault message, converts it to an Error and raises it.
+    # Reads the response body, checks if it is a fault and if so converts it to an Error and raises it.
     #
     # This method is intended for internal use by other components of the SDK. Refrain from using it directly, as
     # backwards compatibility isn't guaranteed.
@@ -63,21 +63,21 @@ module OvirtSDK4
     # @api private
     #
     def check_fault(response)
-      fault = nil
-      unless response.body.to_s.empty?
-        begin
-          reader = XmlReader.new(response.body)
-          fault = FaultReader.read_one(reader)
-        ensure
-          reader.close
-        end
+      body = response.body
+      if body.nil? || body.length == 0
+        raise_error(response, nil)
+      end
+      body = Reader.read(body)
+      if body.is_a?(Fault)
+        raise_error(response, body)
       end
-      raise_error(response, fault)
+      raise Error.new("Expected a fault, but got '#{body.class.name.split('::').last}'")
     end
 
     #
-    # Reads the response body assuming that it contains an action, checks if it contains a fault message, and if it
-    # does converts it to an Error and raises it. If it doesn't contain a fault then it just returns the action object.
+    # Reads the response body and checks if it is an action or a fault. If it is an action it checks if the action
+    # contains a nested fault. If there is a fault then converts it to an `Error` and raises it. If there is no fault
+    # then the action object is returned.
     #
     # This method is intended for internal use by other components of the SDK. Refrain from using it directly, as
     # backwards compatibility isn't guaranteed.
@@ -85,16 +85,19 @@ module OvirtSDK4
     # @api private
     #
     def check_action(response)
-      begin
-        reader = XmlReader.new(response.body)
-        action = ActionReader.read_one(reader)
-      ensure
-        reader.close
+      body = response.body
+      if body.nil? || body.length == 0
+        raise_error(response, nil)
+      end
+      body = Reader.read(body)
+      if body.is_a?(Fault)
+        raise_error(response, body)
       end
-      unless action.fault.nil?
-        raise_error(response, action.fault)
+      if body.is_a?(Action)
+        return body if body.fault.nil?
+        raise_error(response, body.fault)
       end
-      return action
+      raise Error.new("Expected an action or a fault, but got '#{body.class.name.split('::').last}'")
     end
 
   end

data/lib/ovirtsdk4/services.rb

@@ -296,6 +296,12 @@ module OvirtSDK4
   class ImageService < Service
   end
   
+  class ImageTransferService < Service
+  end
+  
+  class ImageTransfersService < Service
+  end
+  
   class ImagesService < Service
   end
   
@@ -3383,7 +3389,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -3410,7 +3416,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -4183,7 +4189,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -4682,7 +4688,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -6998,7 +7004,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -7812,7 +7818,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -7839,7 +7845,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -8819,7 +8825,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -8921,7 +8927,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -8975,7 +8981,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -9059,7 +9065,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -9087,7 +9093,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -9170,7 +9176,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -10929,7 +10935,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -10958,6 +10964,307 @@ module OvirtSDK4
     
   end
   
+  class ImageTransferService < 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
+    
+    # 
+    # Extend the image transfer session.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    def extend(opts = {})
+      action = Action.new(opts)
+      writer = XmlWriter.new(nil, true)
+      ActionWriter.write_one(action, writer)
+      body = writer.string
+      writer.close
+      request = Request.new({
+      :method => :POST,
+      :path => "#{@path}/extend",
+      :body => body,
+      })
+      response = @connection.send(request)
+      case response.code
+      when 200
+        action = check_action(response)
+      else
+        check_action(response)
+      end
+    end
+    
+    # 
+    # After finishing to transfer the data, finalize the transfer.
+    # 
+    # This will make sure that the data being transferred is valid and fits the
+    # image entity that was targeted in the transfer. Specifically, will verify that
+    # if the image entity is a QCOW disk, the data uploaded is indeed a QCOW file,
+    # and that the image doesn't have a backing file.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    def finalize(opts = {})
+      action = Action.new(opts)
+      writer = XmlWriter.new(nil, true)
+      ActionWriter.write_one(action, writer)
+      body = writer.string
+      writer.close
+      request = Request.new({
+      :method => :POST,
+      :path => "#{@path}/finalize",
+      :body => body,
+      })
+      response = @connection.send(request)
+      case response.code
+      when 200
+        action = check_action(response)
+      else
+        check_action(response)
+      end
+    end
+    
+    # 
+    # Get the image transfer entity.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @return [ImageTransfer]
+    # 
+    def get(opts = {})
+      query = {}
+      request = Request.new(:method => :GET, :path => @path, :query => query)
+      response = @connection.send(request)
+      case response.code
+      when 200
+        begin
+          reader = XmlReader.new(response.body)
+          return ImageTransferReader.read_one(reader)
+        ensure
+          reader.close
+        end
+      else
+        check_fault(response)
+      end
+    end
+    
+    # 
+    # Pause the image transfer session.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    def pause(opts = {})
+      action = Action.new(opts)
+      writer = XmlWriter.new(nil, true)
+      ActionWriter.write_one(action, writer)
+      body = writer.string
+      writer.close
+      request = Request.new({
+      :method => :POST,
+      :path => "#{@path}/pause",
+      :body => body,
+      })
+      response = @connection.send(request)
+      case response.code
+      when 200
+        action = check_action(response)
+      else
+        check_action(response)
+      end
+    end
+    
+    # 
+    # Resume the image transfer session. The client will need to poll the transfer's phase until
+    # it is different than `resuming`. For example:
+    # 
+    # [source,python]
+    # ----
+    # transfer_service = transfers_service.image_transfer_service(transfer.id)
+    # transfer_service.resume()
+    # transfer = transfer_service.get()
+    # 
+    # while transfer.phase == types.ImageTransferPhase.RESUMING:
+    #    time.sleep(1)
+    #    transfer = transfer_service.get()
+    # ----
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    def resume(opts = {})
+      action = Action.new(opts)
+      writer = XmlWriter.new(nil, true)
+      ActionWriter.write_one(action, writer)
+      body = writer.string
+      writer.close
+      request = Request.new({
+      :method => :POST,
+      :path => "#{@path}/resume",
+      :body => body,
+      })
+      response = @connection.send(request)
+      case response.code
+      when 200
+        action = check_action(response)
+      else
+        check_action(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 "#<#{ImageTransferService}:#{@path}>"
+    end
+    
+  end
+  
+  class ImageTransfersService < 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
+    
+    # 
+    # Add a new image transfer. An image needs to be specified in order to make
+    # a new transfer.
+    # 
+    # @param image_transfer [ImageTransfer] The `image_transfer` to add.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @return [ImageTransfer]
+    # 
+    def add(image_transfer, opts = {})
+      if image_transfer.is_a?(Hash)
+        image_transfer = OvirtSDK4::ImageTransfer.new(image_transfer)
+      end
+      query = {}
+      request = Request.new(:method => :POST, :path => @path, :query => query)
+      begin
+        writer = XmlWriter.new(nil, true)
+        ImageTransferWriter.write_one(image_transfer, writer)
+        request.body = writer.string
+      ensure
+        writer.close
+      end
+      response = @connection.send(request)
+      case response.code
+      when 201, 202
+        begin
+          reader = XmlReader.new(response.body)
+          return ImageTransferReader.read_one(reader)
+        ensure
+          reader.close
+        end
+      else
+        check_fault(response)
+      end
+    end
+    
+    # 
+    # Retrieves the list of image transfers that are currently
+    # being performed.
+    # 
+    # @param opts [Hash] Additional options.
+    # 
+    # @return [Array<ImageTransfer>]
+    # 
+    def list(opts = {})
+      query = {}
+      request = Request.new(:method => :GET, :path => @path, :query => query)
+      response = @connection.send(request)
+      case response.code
+      when 200
+        begin
+          reader = XmlReader.new(response.body)
+          return ImageTransferReader.read_many(reader)
+        ensure
+          reader.close
+        end
+      else
+        check_fault(response)
+      end
+    end
+    
+    # 
+    # Returns a reference to the service that manages an
+    # specific image transfer.
+    # 
+    # @param id [String] The identifier of the `image_transfer`.
+    # 
+    # @return [ImageTransferService] A reference to the `image_transfer` service.
+    # 
+    def image_transfer_service(id)
+      return ImageTransferService.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 image_transfer_service(path)
+      end
+      return image_transfer_service(path[0..(index - 1)]).service(path[(index +1)..-1])
+    end
+    
+    # 
+    # Returns an string representation of this service.
+    # 
+    # @return [String]
+    # 
+    def to_s
+      return "#<#{ImageTransfersService}:#{@path}>"
+    end
+    
+  end
+  
   class ImagesService < Service
     
     # 
@@ -12158,7 +12465,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -12187,7 +12494,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -12874,7 +13181,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -13886,7 +14193,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -13978,7 +14285,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -14025,7 +14332,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -14404,7 +14711,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -14510,7 +14817,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -14557,7 +14864,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -15383,7 +15690,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -15430,7 +15737,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -18070,7 +18377,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -19172,7 +19479,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -19557,7 +19864,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.is_attached
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -19586,7 +19893,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -19732,7 +20039,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -20344,7 +20651,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -20379,7 +20686,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -20614,7 +20921,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -20647,7 +20954,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -21509,7 +21816,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -21633,6 +21940,14 @@ module OvirtSDK4
       return IconsService.new(@connection, "#{@path}/icons")
     end
     
+    # 
+    # List of all image transfers being performed for image I/O in oVirt.
+    # 
+    # @return [ImageTransfersService] A reference to `image_transfers` service.
+    def image_transfers_service
+      return ImageTransfersService.new(@connection, "#{@path}/imagetransfers")
+    end
+    
     # 
     # Locates the `instance_types` service.
     # 
@@ -21911,6 +22226,12 @@ module OvirtSDK4
       if path.start_with?('icons/')
         return icons_service.service(path[6..-1])
       end
+      if path == 'imagetransfers'
+        return image_transfers_service
+      end
+      if path.start_with?('imagetransfers/')
+        return image_transfers_service.service(path[15..-1])
+      end
       if path == 'instancetypes'
         return instance_types_service
       end
@@ -22466,7 +22787,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -22881,7 +23202,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -22910,7 +23231,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24622,7 +24943,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24651,7 +24972,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24678,7 +24999,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24705,7 +25026,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24738,7 +25059,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24765,7 +25086,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24868,7 +25189,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24897,7 +25218,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24930,7 +25251,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24965,7 +25286,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -24992,7 +25313,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25039,7 +25360,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25066,7 +25387,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25103,7 +25424,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25130,7 +25451,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25157,7 +25478,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25184,7 +25505,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25214,7 +25535,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.ticket
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25241,7 +25562,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -25720,14 +26041,22 @@ module OvirtSDK4
     end
     
     # 
-    # Returns the representation of the object managed by this service.
+    # Returns the information about this CDROM device.
     # 
     # @param opts [Hash] Additional options.
     # 
+    # @option opts [Boolean] :current Indicates if the operation should return the information for the currently running virtual machine. This
+    #   parameter is optional, and the default value is `false`.
+    # 
     # @return [Cdrom]
     # 
     def get(opts = {})
       query = {}
+      value = opts[:current]
+      unless value.nil?
+        value = Writer.render_boolean(value)
+        query['current'] = value
+      end
       request = Request.new(:method => :GET, :path => @path, :query => query)
       response = @connection.send(request)
       case response.code
@@ -25744,49 +26073,31 @@ module OvirtSDK4
     end
     
     # 
-    # Deletes the object managed by this service.
+    # Updates the information about this CDROM device.
     # 
+    # @param cdrom [Cdrom] The information about the CDROM device.
     # @param opts [Hash] Additional options.
     # 
-    # @option opts [Boolean] :async Indicates if the remove should be performed asynchronously.
-    def remove(opts = {})
-      query = {}
-      value = opts[:async]
-      unless value.nil?
-        value = Writer.render_boolean(value)
-        query['async'] = value
-      end
-      request = Request.new(:method => :DELETE, :path => @path, :query => query)
-      response = @connection.send(request)
-      unless response.code == 200
-        check_fault(response)
-      end
-    end
-    
-    # 
-    # Updates the `cdorm`.
-    # 
-    # @param cdorm [Cdrom] The `cdorm` to update.
-    # @param opts [Hash] Additional options.
-    # 
-    # @option opts [Boolean] :async Indicates if the update should be performed asynchronously.
+    # @option opts [Boolean] :current Indicates if the update should apply to the currently running virtual machine, or to the virtual machine
+    #   after the next boot. This parameter is optional, and the default value is `false`, which means that by
+    #   default the update will have effect only after the next boot.
     # 
     # @return [Cdrom]
     # 
-    def update(cdorm)
-      if cdorm.is_a?(Hash)
-        cdorm = OvirtSDK4::Cdrom.new(cdorm)
+    def update(cdrom)
+      if cdrom.is_a?(Hash)
+        cdrom = OvirtSDK4::Cdrom.new(cdrom)
       end
       query = {}
-      value = opts[:async]
+      value = opts[:current]
       unless value.nil?
         value = Writer.render_boolean(value)
-        query['async'] = value
+        query['current'] = value
       end
       request = Request.new(:method => :PUT, :path => @path, :query => query)
       begin
         writer = XmlWriter.new(nil, true)
-        CdromWriter.write_one(cdorm, writer)
+        CdromWriter.write_one(cdrom, writer)
         request.body = writer.string
       ensure
         writer.close
@@ -25848,43 +26159,7 @@ module OvirtSDK4
     end
     
     # 
-    # Adds a new `cdrom`.
-    # 
-    # @param cdrom [Cdrom] The `cdrom` to add.
-    # 
-    # @param opts [Hash] Additional options.
-    # 
-    # @return [Cdrom]
-    # 
-    def add(cdrom, opts = {})
-      if cdrom.is_a?(Hash)
-        cdrom = OvirtSDK4::Cdrom.new(cdrom)
-      end
-      query = {}
-      request = Request.new(:method => :POST, :path => @path, :query => query)
-      begin
-        writer = XmlWriter.new(nil, true)
-        CdromWriter.write_one(cdrom, writer)
-        request.body = writer.string
-      ensure
-        writer.close
-      end
-      response = @connection.send(request)
-      case response.code
-      when 201, 202
-        begin
-          reader = XmlReader.new(response.body)
-          return CdromReader.read_one(reader)
-        ensure
-          reader.close
-        end
-      else
-        check_fault(response)
-      end
-    end
-    
-    # 
-    # Returns the representation of the object managed by this service.
+    # Returns the list of CDROM devices of the virtual machine.
     # 
     # @param opts [Hash] Additional options.
     # 
@@ -25915,7 +26190,7 @@ module OvirtSDK4
     end
     
     # 
-    # Locates the `cdrom` service.
+    # Returns a reference to the service that manages a specific CDROM device.
     # 
     # @param id [String] The identifier of the `cdrom`.
     # 
@@ -25993,7 +26268,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -26020,7 +26295,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -26049,7 +26324,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -26102,7 +26377,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -26429,7 +26704,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.proxy_ticket
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -26725,7 +27000,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -26752,7 +27027,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -27309,7 +27584,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -28997,7 +29272,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29028,7 +29303,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29083,7 +29358,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29310,7 +29585,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29357,7 +29632,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29584,7 +29859,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29691,7 +29966,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.details
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29722,7 +29997,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29769,7 +30044,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29800,7 +30075,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29829,7 +30104,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29858,7 +30133,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29885,7 +30160,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29914,7 +30189,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29941,7 +30216,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -29968,7 +30243,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30064,7 +30339,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30093,7 +30368,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30120,7 +30395,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30152,7 +30427,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30179,7 +30454,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30211,7 +30486,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.power_management
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30238,7 +30513,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30316,7 +30591,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30348,7 +30623,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.iscsi_targets
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30377,7 +30652,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30404,7 +30679,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30603,7 +30878,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30635,7 +30910,7 @@ module OvirtSDK4
         action = check_action(response)
         return action.storage_domains
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -30705,7 +30980,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end
     
@@ -31001,7 +31276,7 @@ module OvirtSDK4
       when 200
         action = check_action(response)
       else
-        check_fault(response)
+        check_action(response)
       end
     end