VMware VCLOUD API 1.0 - API

vCloud API Programming Guide
104 VMware, Inc.
<NetworkPoolReference type="application/vnd.vmware.admin.networkPool+xml"
name="VC2_VLAN_Backed"
href="http://vcloud.example.com/api/v1.0/admin/extension/networkPool/2"/>
</NetworkPoolReferences>
</ProviderVdc>
List the Organization vDCs Supported by a Provider vDC
AnadministratorcanusethehrefvaluefromanyProviderVdcReferenceelementinaVCloudasthetarget
ofarequestthatreturnsalistoforganizationvDCsthattheprovidervDCsupports.
Example 6‐15showsarequestofthistype,madeusingthehrefoftheprovidervDCshowninExample 6‐
2
onpage 94.Theresponse,aVdcReferenceselement,indicatesthattheprovidervDCat
http://vcloud.example.com/api/v1.0/admin/providervdc/2issupportingtheorganizationvDC,
http://vcloud.example.com/api/v1.0/admin/vdc/44,createdinExample 6‐16.
Example 6-15. List the Organization vDCs Supported by a Provider vDC
Request:
GET http://vcloud.example.com/api/v1.0/admin/providervdc/2/vdcReferences
Response:
<VdcReferences xmlns="http://www.vmware.com/vcloud/v1" ... >
<Link rel="up" type="application/vnd.vmware.admin.providervdc+xml"
href="http://vcloud.example.com/api/v1.0/admin/providervdc/2"/>
<VdcReference type="application/vnd.vmware.admin.vdc+xml" name="org3vdc1"
href="http://vcloud.example.com/api/v1.0/admin/vdc/44"/>
</VdcReferences>
Allocate a vDC to an Organization
AnorganizationadministratorcanallocateresourcesfromaprovidervDCtoavDCinanorganizationby
POSTinganAdminVdcbodytoanorganization’saddURLforvDCs.Example 6‐4includessuchaURL:
<Link rel="add" type="application/vnd.vmware.admin.vdc+xml"
href="http://vcloud.example.com/api/v1.0/admin/org/26/vdcs"/>
Example 6‐16usesthatURLtoaddanewvDCtotheorganization.ThenewvDCallocatesresourcesfromthe
providervDCspecifiedintheProviderVdcReferenceelementintherequestbody.Thecontentsofthat
elementwereobtainedfromthiselement,shownintheresponseinExample 6‐2.
<ProviderVdcReference type="application/vnd.vmware.admin.providervdc+xml" name="MainProvider"
href="http://vcloud.example.com/api/v1.0/admin/providervdc/2"/>
<ProviderVdcReference ... />
Example 6-16. Allocate a vDC to an Organization
Request:
POST http://vcloud.example.com/api/v1.0/admin/org/26/vdcs
Content-Type: application/vnd.vmware.admin.vdc+xml
...
<AdminVdc name="org26vdc1" xmlns="http://www.vmware.com/vcloud/v1">
<Description>Example vDC</Description>
<AllocationModel>AllocationPool</AllocationModel>
<StorageCapacity>
<Units>MB</Units>
<Allocated>3072</Allocated>
<Limit>4096</Limit>
</StorageCapacity>
<ComputeCapacity>
<Cpu>