You can retrieve a list of external networks and network pools that have been created on a vCenter server registered to a cloud.
A reference to an external network is required when you create an Edge Gateway. A reference to a network pool is usually required when you create an organization VDC. These resources do not exist in a new vCloud Director installation. A system administrator must create them, as described in Create an External Network and Create a Network Pool.
When you create a Provider VDC, a VxlanPoolType network pool is created automatically on the vCenter server that backs the Provider VDC. See Create a Network Pool.
GET https://vcloud.example.com/api/admin/extension/externalNetworkReferences
Each reference to an external network includes its type, name, and href attributes, as shown in this example.
<vmext:VMWExternalNetworkReferences ... > ... <vmext:ExternalNetworkReference type="application/vnd.vmware.admin.extension.network+xml" name="VC0" href="https://vcloud.example.com/api/admin/extension/externalnet/85" /> <vmext:ExternalNetworkReference type="application/vnd.vmware.admin.extension.network+xml" name="VC1" href="https://vcloud.example.com/api/admin/extension/externalnet/302" /> ... </vmext:VMWExternalNetworkReferences>
The corresponding element for network pools, VMWNetworkPoolReferences, is similar. In most cases, you can supply just the href attribute value when you specify an external network or network pool in an organization network creation request. You can retrieve additional information about the external network or network pool by making a GET request to its href attribute value.