VMware VCLOUD API 1.0 - TECHNICAL NOTE, Programming Manual

Page: 120 / 212

vCloud API Programming Guide
120 VMware, Inc.
<vcloud:Link rel="add" type="application/vnd.vmware.admin.netwxml"
href="http://vcloud.example.com/api/v1.0/admin/extension/networkPools"/>
<vcloud:Link rel="register" type="application/vnd.vmware.admin.registerVimServexml"
href="http://vcloud.example.com/api/v1.0/admin/extension/action/
registervimserver"/>
<vcloud:Link rel="down" type="application/vnd.vmware.admin.licensingRepxml"
href="http://vcloud.example.com/api/v1.0/admin/extension/licensing/reports"/>
</vmext:VMWExtension>
List Provider vDCs in a vCloud
A system administrator can use the providerVdcReferences link returned in a VMWExtension response to
request a list of all provider vDCs in the vCloud. Example 7 ‐ 2 makes such a request, using the
providerVdcReferences link returned in Example 7 ‐ 1 .
Example 7-2. List Provider vDCs in a vCloud
Request:
GET http://vcloud.example.com/api/v1.0/admin/extension/providerVdcReferences
Response:
200 OK
Content-Type: application/vnd.vmware.admin.vmwprovidervdcrefxml
...
<vmext:VMWProviderVdcReferences xmlns:vmext="http://www.vmware.com/vcloud/extension/v1" ... >
<vcloud:Link rel="up" type="application/vnd.vmware.admin.vmwExxml"
href="http://vcloud.example.com/api/v1.0/admin/extension"/>
<vmext:ProviderVdcReference type="application/vnd.vmware.admin.vmwprovxml"
name="PVDC-VC3"
href="http://vcloud.example.com/api/v1.0/admin/extension/providervdc/1"/>
<vmext:ProviderVdcReference ... >
<vmext:ProviderVdcReference ... >
</vmext:VVMWProviderVdcReferences>
List External Networks in a vCloud
This operation follows the model shown in Example 7 ‐ 2 , but uses the externalNetworkReferences link
from the VMWExtension response as the target of the request. The response is a
VMWExternalNetworkReferences element.
List Network Pools in a vCloud
This operation follows the model shown in Example 7 ‐ 2 , but uses the networkPoolReferences link from the
VMWExtension response as the target of the request. The response is a NetworkPoolReferences element.
List vCenter Servers Registered to a vCloud
This operation follows the model shown in Example 7 ‐ 2 , but uses the vimServerReferences link from the
VMWExtension response as the target of the request. The response is a VMWVimServerReferences element.
Get Information About a vCenter Server
A system administrator can use the href attribute value of any VimServerReference in a
VMWVimServerReferences element to get more information about a specific vCenter server, as shown in
Example 7 ‐ 3 .