Citrix Systems 6 User Manual
150
Force an SR scan, syncing the
xapi
database with VDIs present in the underlying storage substrate.
Task Commands
Commands for working with long-running asynchronous tasks. These are tasks such as starting, stopping, and
suspending a Virtual Machine, which are typically made up of a set of other atomic subtasks that together
accomplish the requested operation.
suspending a Virtual Machine, which are typically made up of a set of other atomic subtasks that together
accomplish the requested operation.
The task objects can be listed with the standard object listing command (xe task-list), and the parameters
manipulated with the standard parameter commands. See
manipulated with the standard parameter commands. See
for details.
Task Parameters
Tasks have the following parameters:
Parameter Name
Description
Type
uuid
the unique identifier/object reference for
the Task
the Task
read only
name-label
the name of the Task
read only
name-description
the description string of the Task
read only
resident-on
the unique identifier/object reference of the
host on which the task is running
host on which the task is running
read only
status
current status of the Task
read only
progress
if the Task is still pending, this field contains
the estimated percentage complete, from 0.
to 1. If the Task has completed, successfully
or unsuccessfully, this should be 1.
the estimated percentage complete, from 0.
to 1. If the Task has completed, successfully
or unsuccessfully, this should be 1.
read only
type
if the Task has successfully completed, this
parameter contains the type of the encoded
result, that is, the name of the class whose
reference is in the result field; otherwise,
this parameter's value is undefined
parameter contains the type of the encoded
result, that is, the name of the class whose
reference is in the result field; otherwise,
this parameter's value is undefined
read only
result
if the Task has completed successfully, this
field contains the result value, either Void
or an object reference; otherwise, this
parameter's value is undefined
field contains the result value, either Void
or an object reference; otherwise, this
parameter's value is undefined
read only
error_info
if the Task has failed, this parameter
contains the set of associated error
strings; otherwise, this parameter's value is
undefined
contains the set of associated error
strings; otherwise, this parameter's value is
undefined
read only
allowed_operations
list of the operations allowed in this state
read only
created
time the task has been created
read only
finished
time task finished (i.e. succeeded or failed).
If task-status is pending, then the value of
this field has no meaning
If task-status is pending, then the value of
this field has no meaning
read only
subtask_of
contains the UUID of the tasks this task is a
sub-task of
sub-task of
read only