Class: OvirtSDK4::FilesService

Inherits:
Service
  • Object
show all
Defined in:
lib/ovirtsdk4/services.rb,
lib/ovirtsdk4/services.rb

Instance Method Summary collapse

Methods inherited from Service

#inspect, #to_s

Instance Method Details

#file_service(id) ⇒ FileService

Locates the file service.

Parameters:

  • id (String) —

    The identifier of the file.

Returns:



9629
9630
9631
 
# File 'lib/ovirtsdk4/services.rb', line 9629

def file_service(id)
  FileService.new(self, id)
end

#list(opts = {}) ⇒ Array<File>

Returns the list of ISO images and virtual floppy disks available in the storage domain. The order of the returned list is not guaranteed.

If the refresh parameter is false, the returned list may not reflect recent changes to the storage domain; for example, it may not contain a new ISO file that was recently added. This is because the server caches the list of files to improve performance. To get the very latest results, set the refresh parameter to true.

The default value of the refresh parameter is true, but it can be changed using the configuration value ForceRefreshDomainFilesByDefault:

# engine-config -s ForceRefreshDomainFilesByDefault=false
Important
 Setting the value of the refresh parameter to true has an impact on the performance of the server. Use it only if necessary.

Parameters:

  • opts (Hash) (defaults to: {}) —

    Additional options.

Options Hash (opts):

  • :case_sensitive (Boolean) —

    Indicates if the search performed using the search parameter should take case into account. The default value is true.

  • :follow (String) —

    Indicates which inner links should be followed. The objects referenced by these links will be fetched as part of the current request. See here for details.

  • :max (Integer) —

    Sets the maximum number of files to return. If not specified, all the files are returned.

  • :refresh (Boolean) —

    Indicates whether the list of files should be refreshed from the storage domain, rather than showing cached results that are updated at certain intervals.

  • :search (String) —

    A query string used to restrict the returned files.

  • :headers (Hash) — default: {} —

    Additional HTTP headers.

  • :query (Hash) — default: {} —

    Additional URL query parameters.

  • :timeout (Integer) — default: nil —

    The timeout for this request, in seconds. If no value is explicitly given then the timeout set globally for the connection will be used.

  • :wait (Boolean) — default: true —

    If true wait for the response.

Returns:



9618
9619
9620
 
# File 'lib/ovirtsdk4/services.rb', line 9618

def list(opts = {})
  internal_get(LIST, opts)
end

#service(path) ⇒ Service

Locates the service corresponding to the given path.

Parameters:

  • path (String) —

    The path of the service.

Returns:

  • (Service) —

    A reference to the service.



9640
9641
9642
9643
9644
9645
9646
9647
9648
9649
 
# File 'lib/ovirtsdk4/services.rb', line 9640

def service(path)
  if path.nil? || path == ''
    return self
  end
  index = path.index('/')
  if index.nil?
    return file_service(path)
  end
  return file_service(path[0..(index - 1)]).service(path[(index +1)..-1])
end