VMware VCLOUD API 1.0 - API User Manual

VMware, Inc. 119
Chapter 7 VMware vSphere Platform Operations
List vSphere Platform Operations and Objects for a vCloud
AllresourcesexposedtovCloudtenantsthroughprovidervDCsoriginateinvCenterinstancesregisteredto
thevCloudservice.AsystemadministratorcanrequestalistofvSphereobjectscurrentlyregisteredforuse
withavCloud.Theresponsealsoincludelinkstoactionsthatallowthesystemadministratortoaddorregister

newvSphereobjects.Example 7‐1showsanexampleofsucharequest.
Example 7-1. List All vSphere Platform Operations and Objects for a vCloud
Request:
GET http://vcloud.example.com/api/v1.0/admin/extension
Response:
200 OK
Content-Type: application/vnd.vmware.admin.vmwextension+xml
...
<vmext:VMWExtension xmlns:vmext="http://www.vmware.com/vcloud/extension/v1" ... >
<vcloud:Link rel="down" type="application/vnd.vmware.admin.vmwProviderVdcReferences+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/
providerVdcReferences"/>
<vcloud:Link rel="down" type="application/vnd.vmware.admin.vmwExternalNetworkReferences+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/
externalNetworkReferences"/>
<vcloud:Link rel="down" type="application/vnd.vmware.admin.vmwNetworkPoolReferences+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/
networkPoolReferences"/>
<vcloud:Link rel="down" type="application/vnd.vmware.admin.vmwVimServerReferences+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/
vimServerReferences"/>
<vcloud:Link rel="down" type="application/vnd.vmware.admin.vmwHostReferences+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/hostReferences"/>
<vcloud:Link rel="add" type="application/vnd.vmware.admin.vmwprovidervdc+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/providervdcs"/>
<vcloud:Link rel="add" type="application/vnd.vmware.admin.vmwexternalnet+xml"
href="http://vcloud.example.com/api/v1.0/admin/extension/externalnets"/>
GetInformationAbout
anExternalNetwork
GETAPI‐URL/admin/extension/
externalnet/id
none VMWExternalNetwork
ModifyanExternal
Network
PUTAPI‐URL/admin/extension/
externalnet/id
VMWExternalNetwork VMWExternalNetwork
RemoveanExternal
Network
DELETE
API‐URL/admin/extension/
externalnet/id
none Task
CreateaNetworkPool POSTAPI‐URL/admin/extension/
networkPools
VMWNetworkPool VMWNetworkPool
GetInformationAbout
aNetworkPool
GETAPI‐
URL/admin/extension/
networkPool/id
None VMWExternalNetwork
ModifyaNetworkPool PUTAPI‐URL/admin/extension/
networkPool/id
VMWNetworkPool VMWNetworkPool
RemoveaNetwork
Pool
PUTAPI‐URL/admin/extension/
networkPool/id
None 204NoContent
ImportaVirtual
MachineasavApp
POSTAPI‐URL/admin/extension/
vimServer/id/importVmAsVapp
ImportVmAsVAppParams VApp
ImportaVirtual
MachineasavApp
Template
POSTAPI‐URL/admin/extension/
vimServer/id/
importVmAsVappTemplate
ImportVmAsVAppTemplate
Params
VAppTemplate
Table 7-1. Summary of vSphere Platform Operations Requests (Continued)
Operation Request Request Body Response

VMware VCLOUD API 1.0 - API Specifications

General

Brand	VMware
Model	VCLOUD API 1.0 - API
Category	Software
Language	English