To add a network to an organization VDC, an administrator POSTs an OrgVdcNetwork element to the VDC's add URL for networks.

The contents of the Configuration element of the OrgVdcNetwork define the properties of the network, including its connections to other networks.

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 endpoint as an Account Administrator.

1

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.

GET https://vcloud.example.com/api/admin/vdc/44
2

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:

<Link
   rel="add"
   type="application/vnd.vmware.admin.orgVdcNetwork+xml"
   href="https://vcloud.example.com/api/admin/vdc/44/networks" />
3

Create an OrgVdcNetwork element.

4

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.