PUT /task/{id}

Operation:

PUT /task/{id}

Description:

Update a task.

Since:

5.1

Input parameters

Updated values for the task.

Consume media type(s):

application/vnd.vmware.vcloud.task+xml

Input type:

TaskType

Output parameters

{@link TaskType}

Produce media type(s):

application/vnd.vmware.vcloud.task+xml

Output type:

TaskType

Examples

Request

HTTP 1.1
PUT /api/task/de88f868-8402-4a66-aa7b-18a45223d640

Headers:
Content-Length: 1382
Content-Type: application/vnd.vmware.vcloud.task+xml; charset=ISO-8859-1
x-vcloud-authorization: SZMKkKToUBmDWSEeqZYL2yxpCqDiyToj5PYW3TigOrI=

Body:

<?xml version="1.0" encoding="UTF-8"?><vcloud:Task
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    cancelRequested="false"
    endTime="2013-02-14T13:12:08.618+02:00"
    expiryTime="2013-05-15T13:12:08.618+03:00"
    href="https://vcloud.example.com/api/task/de88f868-8402-4a66-aa7b-18a45223d640"
    id="urn:vcloud:task:de88f868-8402-4a66-aa7b-18a45223d640"
    name="task"
    operation="External processing finished Organization Default(7b832bc5-3d65-45a2-8d35-da28388ab80a)"
    operationName="jobCustom"
    serviceNamespace="ServiceNamespace"
    startTime="2013-02-14T13:12:08.618+02:00"
    status="error"
    type="application/vnd.vmware.vcloud.task+xml">
    <vcloud:Owner
        href="https://vcloud.example.com/api/admin/org/7b832bc5-3d65-45a2-8d35-da28388ab80a"
        name="Default"
        type="application/vnd.vmware.admin.organization+xml"/>
    <vcloud:Error
        majorErrorCode="500"
        message="Some details about the task failure."
        minorErrorCode="501"
        stackTrace="Debug message"/>
    <vcloud:User
        href="https://vcloud.example.com/api/admin/user/007a5dfd-32b4-42dd-813b-bfef3da70cb5"
        name="user"
        type="application/vnd.vmware.admin.user+xml"/>
    <vcloud:Organization
        href="https://vcloud.example.com/api/org/7b832bc5-3d65-45a2-8d35-da28388ab80a"
        name="Default"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <vcloud:Progress>20</vcloud:Progress>
    <vcloud:Details>The task is still in progress.</vcloud:Details>
</vcloud:Task>

Response

HTTP/1.1 200 OK

Headers:
Content-Length: 1490
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><Task
    xmlns="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    cancelRequested="false"
    endTime="2013-02-14T13:12:08.617+02:00"
    expiryTime="2013-05-15T13:12:08.617+03:00"
    href="https://vcloud.example.com/api/task/de88f868-8402-4a66-aa7b-18a45223d640"
    id="urn:vcloud:task:de88f868-8402-4a66-aa7b-18a45223d640"
    name="task"
    operation="External processing finished Organization Default(7b832bc5-3d65-45a2-8d35-da28388ab80a)"
    operationName="jobCustom"
    serviceNamespace="ServiceNamespace"
    startTime="2013-02-14T13:12:08.617+02:00"
    status="error"
    type="application/vnd.vmware.vcloud.task+xml"
    xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <Owner
        href="https://vcloud.example.com/api/admin/org/7b832bc5-3d65-45a2-8d35-da28388ab80a"
        name="Default"
        type="application/vnd.vmware.admin.organization+xml"/>
    <Error
        majorErrorCode="500"
        message="The task is still in progress."
        minorErrorCode="INTERNAL_SERVER_ERROR"
        stackTrace="The task is still in progress."/>
    <User
        href="https://vcloud.example.com/api/admin/user/007a5dfd-32b4-42dd-813b-bfef3da70cb5"
        name="user"
        type="application/vnd.vmware.admin.user+xml"/>
    <Organization
        href="https://vcloud.example.com/api/org/7b832bc5-3d65-45a2-8d35-da28388ab80a"
        name="Default"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Progress>20</Progress>
    <Details>The task is still in progress.</Details>
</Task>