5.1

fail
End the task, setting the status of any transient objects that it created to ERROR.
Task status is set to ERROR.
updateProgress
Reset the timeout value and timeout action for an active task. Use this action
to keep the task alive when it might become subject to a timeout action.
Prerequisites
Verify that you are logged in to the vCloud API as a system administrator.
Procedure
1 Retrieve the list of active blocking tasks.
See “Monitor Blocking Tasks,” on page 276. If you are using an AMQP client to handle blocking tasks,
skip this step. Each blocking task creates its own AMQP message, which contains a reference to the
BlockingTask.
2 Retrieve an individual BlockingTask.
See the request portion of “Example: Handling a Blocking Task,” on page 278.
3 Make a request.
Action Request
resume
POST a BlockingTaskOperationParams element to the Link where
rel="resume"
abort
POST a BlockingTaskOperationParams element to the Link where
rel="abort"
fail
POST a BlockingTaskOperationParams element to the Link where
rel="fail"
updateProgress
POST a BlockingTaskUpdateProgressParams element to the Link where
rel="updateProgress"
Example: Handling a Blocking Task
This request shows how to retrieve a blocking task without using an AMQP client. “Example: Notification
Message Format,” on page 268 shows how to retrieve the same task using information in the AMQP message.
Request:
GET https://vcloud.example.com/api/admin/extension/blockingTask/25
Response:
200 OK
Content-Type: application/vnd.vmware.admin.blockingTask+xml
...
<vmext:BlockingTask
xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
status="active"
timeoutDate="2011-05-07T16:25:18.857+03:00"
timeoutAction="abort"
createdTime="2011-05-02T16:25:18.857+03:00"
name="importSingletonTemplate"
id="urn:vcloud:blockingTask:25"
type="application/vnd.vmware.admin.blockingTask+xml"
href="https://vcloud.example.com/api/admin/extension/blockingTask/25">
<vcloud:Link
vCloud API Programming Guide
278 VMware, Inc.