VMware VCLOUD API 1.0 - API

vCloud API Programming Guide
134 VMware, Inc.
Response:
201 Created
Content-Type: application/vnd.vmware.admin.vmwexternalnet+xml
...
<vmext:VMWExternalNetwork xmlns:vmext="http://www.vmware.com/vcloud/extension/v1"
xmlns:vcloud="http://www.vmware.com/vcloud/v1" name="ExternalNet-VC100"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
<vcloud:Link rel="alternate" type="application/vnd.vmware.admin.network+xml"
href="http://vcloud.example.com/api/v1.0/admin/network/27"/>
<vcloud:Link rel="edit" type="application/vnd.vmware.admin.network+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
<vcloud:Link rel="remove"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
<vcloud:Description>Portgroup-25 on VC-100</vcloud:Description>
<vcloud:Tasks>
<vcloud:Task status="running"...
operation="Creating External Network ExternalNet-VC100(27)"
href="http:// vcloud.example.com/api/v1.0/task/579"/>
</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 7‐23retrievesinformationabouttheexternal
networkcreatedinExample 7‐22.TheentireVMWExternalNetworkbodyisreturnedintheresponse,butonly
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"
xmlns:vcloud="http://www.vmware.com/vcloud/v1" name="ExternalNet-VC100"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
<vcloud:Link rel="alternate" type="application/vnd.vmware.admin.network+xml"
href="http://vcloud.example.com/api/v1.0/admin/network/27"/>
<vcloud:Link rel="edit" type="application/vnd.vmware.admin.network+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
<vcloud:Link rel="remove"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnet/27"/>
<vcloud:Description>Portgroup-25 on VC-100</vcloud:Description>
<vcloud:Configuration>
...
</vcloud:Configuration>
<vmext:VimPortGroupRef>
<vmext:VimServerRef type="application/vnd.vmware.admin.vmwvserver+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/vimServer/100"/>
<vmext:MoRef>dvportgroup-25</vmext:MoRef>
<vmext:VimObjectType>NETWORK</vmext:VimObjectType>
</vmext:VimPortGroupRef>
</vmext:VMWExternalNetwork>