Whenever you create a vApp network or update its configuration, you might also need to update the NetworkConnectionSection elements of the virtual machines in the vApp.

Verify that you are logged in to the vCloud API as an administrator, Catalog Author, or vApp Author.


Retrieve the virtual machine's NetworkConnectionSection.


Modify the returned NetworkConnectionSection as needed.

Modified sections must contain all required elements, even if you are not changing their values. Because optional elements revert to default values if they are omitted or empty, it is a best practice to include optional elements in updates. Link elements and href attributes from responses do not need to be included in modified sections. Some elements and attributes might be read-only. See the schema reference for details.


Update the section with your modifications.


In the retrieved section, find the Link element where rel="edit".


Make a PUT request to the URL in that link's href attribute value, and supply the modified section as the request body.

The response to this request is a Task element that tracks the update operation. When the task is complete, the section is updated.

This example modifies the NetworkConnectionSection shown in Example: Configuration Links in a Vm Element so that this network connection is compatible with the reconfigured vApp network to which it must connect. See Example: Update a NetworkConfigSection. The modified NetworkConnectionSection in the request changes two values:

The IpAddress now specifies the address to which the vApp network's firewall allows access.

Because it specifies an IP address, the modified NetworkConnectionSection also changes the value of the IpAddressAllocationMode from DHCP to STATIC.


The ovf:Info element is a required member of NetworkConnectionSection and all other sections that are derived from ovf:SectionType. The element must be present, even if it has no content. In this example, we use the content to explain why the connection is configured this way.


PUT "https://vcloud.example.com/api/vApp/vm-4/networkConnectionSection/
Content-type: application/vnd.vmware.vcloud.networkConnectionSection+xml
<?xml version="1.0" encoding="UTF-8"?>
   <ovf:Info>Firewall allows access to this address.</ovf:Info>


202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
<Task ... operation="Updating Virtual Application Linux FTP server (7)" ...>