lib/fog/vcloud_director/requests/compute/get_task_list.rb
module Fog
module Compute
class VcloudDirector
class Real
extend Fog::Deprecation
deprecate :get_tasks_list, :get_task_list
# Retrieve a list of this organization's queued, running, or recently
# completed tasks.
#
# @param [String] id Object identifier of the organization.
# @return [Excon::Response]
# * body<~Hash>:
# * :href<~String> - The URI of the entity.
# * :type<~String> - The MIME type of the entity.
# * :id<~String> - The entity identifier, expressed in URN format.
# The value of this attribute uniquely identifies the entity,
# persists for the life of the entity, and is never reused.
# * :name<~String> - The name of the entity.
# * :Task<~Array<Hash>>:
# * :href<~String> - The URI of the entity.
# * :type<~String> - The MIME type of the entity.
# * :id<~String> - The entity identifier, expressed in URN
# format. The value of this attribute uniquely identifies the
# entity, persists for the life of the entity, and is never
# reused.
# * :operationKey<~String> - Optional unique identifier to
# support idempotent semantics for create and delete
# operations.
# * :name<~String> - The name of the entity.
# * :cancelRequested<~String> - Whether user has requested this
# processing to be canceled.
# * :endTime<~String> - The date and time that processing of the
# task was completed. May not be present if the task is still
# being executed.
# * :expiryTime<~String> - The date and time at which the task
# resource will be destroyed and no longer available for
# retrieval. May not be present if the task has not been
# executed or is still being executed.
# * :operation<~String> - A message describing the operation that
# is tracked by this task.
# * :operationName<~String> - The short name of the operation
# that is tracked by this task.
# * :serviceNamespace<~String> - Identifier of the service that
# created the task.
# * :startTime<~String> - The date and time the system started
# executing the task. May not be present if the task has not
# been executed yet.
# * :status<~String> - The execution status of the task.
# * :Link<~Array<Hash>>:
# * :Description<~String> - Optional description.
# * :Owner<~Hash> - Reference to the owner of the task. This is
# typically the object that the task is creating or updating.
# * :href<~String> - Contains the URI to the entity.
# * :name<~String> - Contains the name of the entity.
# * :type<~String> - Contains the type of the entity.
# * :Error<~Hash> - Represents error information from a failed
# task.
# * :majorErrorCode<~String> - The class of the error. Matches
# the HTTP status code.
# * :message<~String> - An one line, human-readable message
# describing the error that occurred.
# * :minorErrorCode<~String> - Resource-specific error code.
# * :stackTrace<~String> - The stack trace of the exception.
# * :vendorSpecificErrorCode<~String> - A vendor- or
# implementation-specific error code that can reference
# specific modules or source lines for diagnostic purposes.
# * :User<~Hash> - The user who started the task.
# * :href<~String> - Contains the URI to the entity.
# * :name<~String> - Contains the name of the entity.
# * :type<~String> - Contains the type of the entity.
# * :Organization<~Hash> - The organization to which the :User
# belongs.
# * :href<~String> - Contains the URI to the entity.
# * :name<~String> - Contains the name of the entity.
# * :type<~String> - Contains the type of the entity.
# * :Progress<~String> - Read-only indicator of task progress as
# an approximate percentage between 0 and 100. Not available
# for all tasks.
# * :Params
# * :Details<~String> - Detailed message about the task. Also
# contained by the :Owner entity when task status is
# preRunning.
#
# @raise [Fog::Compute::VcloudDirector::BadRequest]
# @raise [Fog::Compute::VcloudDirector::Forbidden]
#
# @see http://pubs.vmware.com/vcd-51/topic/com.vmware.vcloud.api.reference.doc_51/doc/operations/GET-TaskList.html
# @since vCloud API version 0.9
def get_task_list(id)
response = request(
:expects => 200,
:idempotent => true,
:method => 'GET',
:parser => Fog::ToHashDocument.new,
:path => "tasksList/#{id}"
)
ensure_list! response.body, :Task
response
end
end
class Mock
def get_task_list(id)
unless id == data[:org][:uuid]
raise Fog::Compute::VcloudDirector::Forbidden.new(
"No access to entity \"com.vmware.vcloud.entity.org:#{id}\"."
)
end
body = {
:xmlns => xmlns,
:xmlns_xsi => xmlns_xsi,
:xsi_schemaLocation => xsi_schema_location,
:href => make_href("tasksList/#{id}"),
:type => "application/vnd.vmware.vcloud.tasksList+xml",
:name => "Tasks Lists",
:Task => data[:tasks].keys.map {|task_id| task_body(task_id)}
}
Excon::Response.new(
:status => 200,
:headers => {'Content-Type' => "#{body[:type]};version=#{api_version}"},
:body => body
)
end
end
end
end
end