PUT /vApp/{id}/guestCustomizationSection

Operation:

PUT /vApp/{id}/guestCustomizationSection

Description:

Updates the guest customization section of a VM.

Since:

1.0

Input parameters

Consume media type(s):

application/vnd.vmware.vcloud.guestCustomizationSection+xml

Input type:

GuestCustomizationSectionType

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

Output type:

TaskType

Examples

Request

HTTP 1.1
PUT /api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/guestCustomizationSection/

Headers:
Content-Length: 1381
Content-Type: application/vnd.vmware.vcloud.guestCustomizationSection+xml; charset=ISO-8859-1
x-vcloud-authorization: uJ13vBx80VGzZ0KcClBqxHNDJr3QI0K5KaQ0YKn2YZ0=

Body:

<?xml version="1.0" encoding="UTF-8"?><vcloud:GuestCustomizationSection
    xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1"
    xmlns:vcloud="http://www.vmware.com/vcloud/v1.5"
    href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/guestCustomizationSection/"
    ovf:required="false"
    type="application/vnd.vmware.vcloud.guestCustomizationSection+xml">
    <ovf:Info>Specifies Guest OS Customization Settings</ovf:Info>
    <vcloud:Enabled>false</vcloud:Enabled>
    <vcloud:ChangeSid>false</vcloud:ChangeSid>
    <vcloud:VirtualMachineId>89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4</vcloud:VirtualMachineId>
    <vcloud:JoinDomainEnabled>false</vcloud:JoinDomainEnabled>
    <vcloud:UseOrgSettings>false</vcloud:UseOrgSettings>
    <vcloud:AdminPasswordEnabled>false</vcloud:AdminPasswordEnabled>
    <vcloud:AdminPasswordAuto>true</vcloud:AdminPasswordAuto>
    <vcloud:AdminAutoLogonEnabled>false</vcloud:AdminAutoLogonEnabled>
    <vcloud:AdminAutoLogonCount>0</vcloud:AdminAutoLogonCount>
    <vcloud:ResetPasswordRequired>false</vcloud:ResetPasswordRequired>
    <vcloud:ComputerName>importedVap-001</vcloud:ComputerName>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4/guestCustomizationSection/"
        rel="edit"
        type="application/vnd.vmware.vcloud.guestCustomizationSection+xml"/>
</vcloud:GuestCustomizationSection>

Response

HTTP/1.1 202 Accepted

Headers:
Content-Length: 1338
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Location: https://vcloud.example.com/api/task/83edaeca-d738-44a6-aeea-92cbccdd9e64
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"
    expiryTime="2013-05-15T13:17:47.459+03:00"
    href="https://vcloud.example.com/api/task/83edaeca-d738-44a6-aeea-92cbccdd9e64"
    id="urn:vcloud:task:83edaeca-d738-44a6-aeea-92cbccdd9e64"
    name="task"
    operation="Updating Virtual Machine importedVapp(89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4)"
    operationName="vappUpdateVm"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-14T13:17:47.459+02:00"
    status="running"
    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">
    <Link
        href="https://vcloud.example.com/api/task/83edaeca-d738-44a6-aeea-92cbccdd9e64/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/vApp/vm-89c84bd6-c6f2-4e4c-8a7d-c44a3489e2e4"
        name="importedVapp"
        type="application/vnd.vmware.vcloud.vm+xml"/>
    <User
        href="https://vcloud.example.com/api/admin/user/1260efee-6915-494c-8afa-84e7e6d8a310"
        name="system"
        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"/>
    <Details/>
</Task>