Get Information About An External Network - VMware VCLOUD API 1.0 - API Programming Manual

vCloud API Programming Guide
Response:
201 Created
Content-Type: application/vnd.vmware.admin.vmwexternalnet+xml
...
<vmext:VMWExternalNetwork xmlns:vmext="http://www.vmware.com/vcloud/extension/v1"
<vcloud:Link rel="alternate" type="application/vnd.vmware.admin.network+xml"
<vcloud:Link rel="edit" type="application/vnd.vmware.admin.network+xml"
<vcloud:Link rel="remove"
<vcloud:Description>Portgroup-25 on VC-100</vcloud:Description>
<vcloud:Tasks>
<vcloud:Task status="running"...
</vcloud:Tasks>
...
</vmext:VMWExternalNetwork>
The response echoes the request and includes Link elements for actions and related references, and a Task
element that tracks creation of the external network.

Get Information About an External Network

A system administrator can use the href attribute value of any ExternalNetworkReference element to get
more information about a specific external network. Example
network created in Example
part of the response is shown in the example
Example 7-23. Get Information About an External Network
Request:
GET http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27
Response:
200 OK
Content-Type: application/vnd.vmware.admin.vmwexternalnet+xml
...
<vmext:VMWExternalNetwork xmlns:vmext="http://www.vmware.com/vcloud/extension/v1"
<vcloud:Link rel="alternate" type="application/vnd.vmware.admin.network+xml"
<vcloud:Link rel="edit" type="application/vnd.vmware.admin.network+xml"
<vcloud:Link rel="remove"
<vcloud:Description>Portgroup-25 on VC-100</vcloud:Description>
<vcloud:Configuration>
...
</vcloud:Configuration>
<vmext:VimPortGroupRef>
<vmext:VimServerRef type="application/vnd.vmware.admin.vmwvserver+xml"
<vmext:MoRef>dvportgroup-25</vmext:MoRef>
<vmext:VimObjectType>NETWORK</vmext:VimObjectType>
</vmext:VimPortGroupRef>
</vmext:VMWExternalNetwork>
134
xmlns:vcloud="http://www.vmware.com/vcloud/v1" name="ExternalNet-VC100"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
href="http://vcloud.example.com/api/v1.0/admin/network/27"/>
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
operation="Creating External Network ExternalNet-VC100(27)"
href="http:// vcloud.example.com/api/v1.0/task/579"/>
7‐22. The entire VMWExternalNetwork body is returned in the response, but only
xmlns:vcloud="http://www.vmware.com/vcloud/v1" name="ExternalNet-VC100"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
href="http://vcloud.example.com/api/v1.0/admin/network/27"/>
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
href="http://vcloud.example.com/api/v1.0/admin/extension/vimServer/100"/>
7‐23 retrieves information about the external
VMware, Inc.