POST /vApp/{id}/action/recomposeVApp

Operation:

POST /vApp/{id}/action/recomposeVApp

Description:

Recompose a vApp to add or remove VMs.

Since:

1.0

Input parameters

Consume media type(s):

application/vnd.vmware.vcloud.recomposeVAppParams+xml
application/vnd.vmware.vcloud.recomposeVAppParams+json

Input type:

RecomposeVAppParamsType

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/vapp-6943025b-dd0d-4b3b-bf7a-e23135a253a7/action/recomposeVApp

Headers:
x-vcloud-authorization: pUeNVnyn9mWLKeixJUds8H632io+BHj6Xm3qSRt9BCQ=

Body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns6:RecomposeVAppParams
    xmlns="http://www.vmware.com/vcloud/versions" xmlns:ns2="http://schemas.dmtf.org/ovf/envelope/1" xmlns:ns3="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_VirtualSystemSettingData" xmlns:ns4="http://schemas.dmtf.org/wbem/wscim/1/common" xmlns:ns5="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData" xmlns:ns6="http://www.vmware.com/vcloud/v1.5" xmlns:ns7="http://www.vmware.com/schema/ovf" xmlns:ns8="http://schemas.dmtf.org/ovf/environment/1" xmlns:ns9="http://www.vmware.com/vcloud/extension/v1.5"
    linkedClone="false"
    powerOn="false"
    deploy="true"
    name="vApp Name">
    <ns6:Description>vApp Description</ns6:Description>
    <ns6:VAppParent
        type="application/vnd.vmware.vcloud.vApp+xml"
        name="vApp_linux"
        id="urn:vcloud:vapp:6943025b-dd0d-4b3b-bf7a-e23135a253a7"
        href="https://vcloud.example.com/api/vApp/vapp-6943025b-dd0d-4b3b-bf7a-e23135a253a7"/>
    <ns6:AllEULAsAccepted>false</ns6:AllEULAsAccepted>
</ns6:RecomposeVAppParams>

Response

HTTP/1.1 202 Accepted

Headers:
Content-Length: 1349
Content-Type: application/vnd.vmware.vcloud.task+xml; version=5.5
Location: https://vcloud.example.com/api/task/44961494-cc57-4cf0-8f52-0aa60acb15a8
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:34:00.114+02:00"
    serviceNamespace="com.vmware.vcloud"
    operationName="vdcRecomposeVapp"
    operation="Recomposing Virtual Application vApp Name(6943025b-dd0d-4b3b-bf7a-e23135a253a7)"
    expiryTime="2013-06-27T10:34:00.114+03:00"
    cancelRequested="false"
    name="task"
    id="urn:vcloud:task:44961494-cc57-4cf0-8f52-0aa60acb15a8"
    type="application/vnd.vmware.vcloud.task+xml"
    href="https://vcloud.example.com/api/task/44961494-cc57-4cf0-8f52-0aa60acb15a8"
    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/44961494-cc57-4cf0-8f52-0aa60acb15a8/action/cancel"/>
    <Owner
        type="application/vnd.vmware.vcloud.vApp+xml"
        name="vApp Name"
        href="https://vcloud.example.com/api/vApp/vapp-6943025b-dd0d-4b3b-bf7a-e23135a253a7"/>
    <User
        type="application/vnd.vmware.admin.user+xml"
        name="system"
        href="https://vcloud.example.com/api/admin/user/8fa42d37-5eda-43ed-ad8a-f005c625a96c"/>
    <Organization
        type="application/vnd.vmware.vcloud.org+xml"
        name="Default"
        href="https://vcloud.example.com/api/org/b5d81989-f274-4e55-9005-b53b48a158d1"/>
    <Progress>1</Progress>
    <Details/>
</Task>