VMware Cloud Director API - POST-InstallVMwareTools

POST /vApp/{id}/action/installVMwareTools

Operation:

Description:

Install VMware Tools on a running VM.

Since:

1.5

Input parameters

Consume media type(s):: None
Input type:: None

Output parameters

TaskType

This operation is asynchronous and returns a task that you can monitor to track the progress of the request.

Produce media type(s):: application/vnd.vmware.vcloud.task+xml
application/vnd.vmware.vcloud.task+json
Output type:: TaskType

Examples

Request: HTTP 1.1
POST /api/vApp/vm-77a6ac09-7c33-4eaa-9c52-d16be22bfc10/action/installVMwareTools

Headers:
x-vcloud-authorization: ICoTzewXTOpRlM6gpGqRU4pYUEH567upswoaaPvs87Y=

Body:
Response: HTTP/1.1 202 Accepted

Headers:
Content-Length: 1337
Content-Type: application/vnd.vmware.vcloud.task+xml; version=5.5
Location: https://vcloud.example.com/api/task/bcf279af-9d15-4105-8b52-d2070596142c
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?>
<Task
    xmlns="http://www.vmware.com/vcloud/v1.5"
    status="running"
    startTime="2013-03-29T10:17:29.300+02:00"
    serviceNamespace="com.vmware.vcloud"
    operationName="vappInstallTools"
    operation="Installing VMware Tools on Virtual Machine DamnSmallLinux(77a6ac09-7c33-4eaa-9c52-d16be22bfc10)"
    expiryTime="2013-06-27T10:17:29.300+03:00"
    cancelRequested="false"
    name="task"
    id="urn:vcloud:task:bcf279af-9d15-4105-8b52-d2070596142c"
    type="application/vnd.vmware.vcloud.task+xml"
    href="https://vcloud.example.com/api/task/bcf279af-9d15-4105-8b52-d2070596142c"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://vcloud.example.com/api/v1.5/schema/master.xsd">
    <Link
        rel="task:cancel"
        href="https://vcloud.example.com/api/task/bcf279af-9d15-4105-8b52-d2070596142c/action/cancel"/>
    <Owner
        type="application/vnd.vmware.vcloud.vm+xml"
        name="DamnSmallLinux"
        href="https://vcloud.example.com/api/vApp/vm-77a6ac09-7c33-4eaa-9c52-d16be22bfc10"/>
    <User
        type="application/vnd.vmware.admin.user+xml"
        name="admin"
        href="https://vcloud.example.com/api/admin/user/8fa42d37-5eda-43ed-ad8a-f005c625a96c"/>
    <Organization
        type="application/vnd.vmware.vcloud.org+xml"
        name="System"
        href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"/>
    <Details/>
</Task>