VMware Cloud Director API - PUT-NetworkConfigSection-vApp

PUT /vApp/{id}/networkConfigSection

Operation:

PUT /vApp/{id}/networkConfigSection

Description:

Update the network config section of a vApp.

Since:

0.9

Input parameters

Consume media type(s):: application/vnd.vmware.vcloud.networkConfigSection+xml
application/vnd.vmware.vcloud.networkConfigSection+json
Input type:: NetworkConfigSectionType

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
PUT /api/vApp/vapp-bba47763-0ce1-45b9-8470-ea29ba58c52f/networkConfigSection/

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

Body:

<?xml version="1.0" encoding="UTF-8"?><vcloud:NetworkConfigSection
    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/vapp-bba47763-0ce1-45b9-8470-ea29ba58c52f/networkConfigSection/"
    ovf:required="false"
    type="application/vnd.vmware.vcloud.networkConfigSection+xml">
    <ovf:Info>The configuration parameters for logical networks</ovf:Info>
    <vcloud:Link
        href="https://vcloud.example.com/api/vApp/vapp-bba47763-0ce1-45b9-8470-ea29ba58c52f/networkConfigSection/"
        rel="edit"
        type="application/vnd.vmware.vcloud.networkConfigSection+xml"/>
    <vcloud:NetworkConfig
        networkName="VM Network">
        <vcloud:Link
            href="https://vcloud.example.com/api/admin/network/82af5cfc-1f17-40b5-bc19-e8122a599ad2/action/reset"
            rel="repair"/>
        <vcloud:Description>new description</vcloud:Description>
        <vcloud:Configuration>
            <vcloud:IpScopes>
                <vcloud:IpScope>
                    <vcloud:IsInherited>false</vcloud:IsInherited>
                    <vcloud:Gateway>192.168.254.1</vcloud:Gateway>
                    <vcloud:Netmask>255.255.255.0</vcloud:Netmask>
                    <vcloud:IsEnabled>true</vcloud:IsEnabled>
                    <vcloud:IpRanges>
                        <vcloud:IpRange>
                            <vcloud:StartAddress>192.168.254.100</vcloud:StartAddress>
                            <vcloud:EndAddress>192.168.254.199</vcloud:EndAddress>
                        </vcloud:IpRange>
                    </vcloud:IpRanges>
                </vcloud:IpScope>
            </vcloud:IpScopes>
            <vcloud:FenceMode>isolated</vcloud:FenceMode>
            <vcloud:RetainNetInfoAcrossDeployments>false</vcloud:RetainNetInfoAcrossDeployments>
        </vcloud:Configuration>
        <vcloud:IsDeployed>false</vcloud:IsDeployed>
    </vcloud:NetworkConfig>
</vcloud:NetworkConfigSection>
Response: HTTP/1.1 202 Accepted

Headers:
Content-Length: 1361
Content-Type: application/vnd.vmware.vcloud.task+xml;version=5.5
Location: https://vcloud.example.com/api/task/70e69580-5206-4b1e-9741-3da8e7531673
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:17.744+03:00"
    href="https://vcloud.example.com/api/task/70e69580-5206-4b1e-9741-3da8e7531673"
    id="urn:vcloud:task:70e69580-5206-4b1e-9741-3da8e7531673"
    name="task"
    operation="Updating Virtual Application importedVapp(bba47763-0ce1-45b9-8470-ea29ba58c52f)"
    operationName="vdcUpdateVappNetworkSection"
    serviceNamespace="com.vmware.vcloud"
    startTime="2013-02-14T13:17:17.744+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/70e69580-5206-4b1e-9741-3da8e7531673/action/cancel"
        rel="task:cancel"/>
    <Owner
        href="https://vcloud.example.com/api/vApp/vapp-bba47763-0ce1-45b9-8470-ea29ba58c52f"
        name="importedVapp"
        type="application/vnd.vmware.vcloud.vApp+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>