To add a network to an organization VDC, an administrator POSTs an OrgVdcNetwork element to the VDC's add URL for networks. An organization VDC network with a direct connection to an external network must be created by a system administrator. All other organization VDC network types can be created by either a system administrator or an organization administrator.

The contents of the Configuration element of the OrgVdcNetwork define the properties of the network, including its connections to other networks. See Create an Organization VDC Network With a Direct Connection, Create an Organization VDC Network With a Routed Connection, and Create an Isolated Organization VDC Network.

For more information about the types of networks you can create and the resources on which they depend, see About vCloud Director Networks.

Verify that you are logged in to the vCloud API as an organization administrator or system administrator.


Retrieve the XML representation of the organization VDC to which you want to add the network.

This request retrieves the admin view of an organization VDC.


Examine the response to locate the Link element that contains the URL for adding networks to the VDC.

This element has a rel attribute value of add and a type attribute value of application/vnd.vmware.admin.orgVdcNetwork+xml, as shown here:

      href="" />

Create an OrgVdcNetwork element.


POST the OrgVdcNetwork element to the URL described in Step 2.

The server takes the requested action and returns a Task element that tracks the progress of the request. The Owner element of this task includes the href attribute of the new network. When the task completes, you can use the value of this attribute with a GET request to retrieve the XML representation of the new network.