1.5

3 Choose a provider vDC to supply resources for the new organization vDC.
a Retrieve the XML representation of the VCloud object and examine the ProviderVdcReferences element
it contains.
The following request retrieves the representation of the VCloud object:
GET https://vcloud.example.com/api/admin
The VCloud element contains a ProviderVdcReferences element . Each provider vDC available to the
organization is represented in that element by a ProviderVdcReference element, as shown here:
<ProviderVdcReference
type="application/vnd.vmware.admin.providervdc+xml"
name="Main Provider"
href="https://vcloud.example.com/api/admin/providervdc/2"/>
b (Optional) List the organization vDCs that each ProviderVdc supports.
The following request retrieves the list of organization vDCs that .../providervdc/2 supports:
GET https://vcloud.example.com/api/admin/providervdc/2/vdcReferences
Taking this optional step can help you allocate ProviderVdc resources equitably across the
organization vDCs in a cloud.
4 Create an AdminVdc request body.
Include the ProviderVdcReference element you chose in Step 3. You must also include an
AllocationModel element that specifies how provider vDC resources are allocated by this vDC. Choose
one of the following values for AllocationModel:
AllocationVApp
Pay as you go. Resources are committed to a vDC only when vApps are
created in it. When you use this allocation model, any Limit values you
specify for Memory and CPU are ignored when you create a vApp and
returned as 0 when retrieve the request results. Resources available to this
kind of vDC can grow or shrink as needed when its provider vDC has
multiple resource pools.
AllocationPool
Only a percentage of the resources you allocate are committed to the
organization vDC.
ReservationPool
All the resources you allocate are committed as a pool to the organization
vDC. vApps in vDCs that support this allocation model can specify values
for resources and limitations.
See the request portion of “Example: Allocate a vDC to an Organization,” on page 140.
5 POST the AdminVdc request body to the organization's add link for vdcs.
See the request portion of “Example: Allocate a vDC to an Organization,” on page 140.
The server creates the new vDC in the specified organization and returns an AdminVdc element that includes
the contents you POSTed. The server also returns a set of Link elements that you can use to access, remove, or
modify the new vDC. Users can reference this vDC using the URL specified in the href attribute in the Link
where rel="alternate". See the response portion of “Example: Allocate a vDC to an Organization,” on
page 140.
Example: Allocate a vDC to an Organization
This example allocates an AllocationvApp vDC to the organization created in “Example: Create an
Organization,” on page 113.
vCloud API Programming Guide
140 VMware, Inc.