1.5
Table Of Contents
- vCloud API Programming Guide
- Contents
- vCloud API Programming Guide
- About the VMware vCloud API
- Hello vCloud: A Simplified RESTful Workflow
- Exploring a Cloud
- Provisioning an Organization with vApps, Templates, and Media
- Deploying and Operating vApps
- Summary of vCloud API vApp and Virtual Machine Operations Requests
- Create a vApp From a Template
- Compose a vApp From Existing Virtual Machines
- Recompose a vApp to Add or Remove Virtual Machines
- Operate a vApp
- Configuring vApps and Virtual Machines
- Retrieve the Configuration Links for a vApp
- Retrieve the Configuration Links for a Virtual Machine
- Retrieve or Update a Modifiable Section
- Update a vApp Network Configuration
- Update the NetworkConnectionSection of a Virtual Machine
- Retrieve or Modify the CPU Configuration of a Virtual Machine
- Retrieve or Modify the GuestCustomizationSection of a Virtual Machine
- Retrieve or Modify ProductSection Elements
- Retrieve or Modify Groups of Related Sections in a Virtual Machine
- Retrieve or Modify the Hard Disk Configuration of a Virtual Machine
- Creating, Provisioning, and Managing Organizations
- Summary of Administrative Requests
- Administrator Credentials and Privileges
- Organization Administration
- Network Administration
- vDC Administration
- Catalog Administration
- User and Group Administration
- Working With Roles and Rights
- Controlling Access to vApps and Catalogs
- Using vCloud API Extensions to Provision and Manage a Cloud
- Working With Object Metadata
- Using the Query Service
- Configuring and Using Blocking Tasks and Notifications
- XML Representations in the vCloud API
- Index
Create a Provider vDC
A Provider vDC is a collection of compute, memory, and storage resources from one vCenter. A system
administrator can make resources from a provider vDC available through organization vDCs in the cloud.
A Provider vDC is represented as a VMWProviderVdc element in the extension view and a ProviderVdc element
in the admin view. A system administrator can create a VMWProviderVdc or modify it to add or remove datastores
and resource pools, or change other properties such as its description. A system administrator cannot change
the primary resource pool or vCenter server that were specified at creation time. An organization administrator
can retrieve a read-only representation of a provider vDC in a ProviderVdc element.
For information about choosing a resource pool, see “Retrieve a List of Resource Pools from a vCenter
Server,” on page 168. For information about adding or removing a resource pool, see “Add Resource Pools to
a Provider vDC,” on page 178.
Prerequisites
Verify that you are logged in as a system administrator.
Procedure
1 Retrieve the XML representation of the vSphere platform extensions.
Use a request like this one.
GET https://vcloud.example.com/api/admin/extension
2 Examine the response to locate the Link element that contains the URL for adding provider vDCs to the
cloud.
This element has a rel attribute value of add and a type attribute value of
application/vnd.vmware.admin.vmwprovidervdc+xml, as shown here:
<Link
type="application/vnd.vmware.admin.vmwprovidervdc+xml"
rel="add"
href="https://vcloud.example.com/api/admin/extension/providervdcs"/>
3 Choose a vCenter server to provide a resource pool and datastores.
4 Create a VMWProviderVdc element that specifies the properties of the provider vDC.
In the DataStoreRefs and ResourcePoolRef elements of the VMWProviderVdc, use the href attribute value
of the VimServer you selected in Step 3. Use the MoRef and VimObjectType values of the resource pool and
datastores as they appear in the ResourcePool element from the resource pool list. See the request portion
of “Example: Create a Provider vDC,” on page 174.
NOTE You must specify exactly one resource pool when you create the provider vDC. You can add more
resource pools after the provider vDC is created.
5 POST the VMWProviderVdc element you created in Step 4 to the URL described in Step 2.
See the request portion of “Example: Create a Provider vDC,” on page 174.
The server creates and enables the provider vDC and returns a VMWProviderVdc element that includes the
contents you POSTed, along with a set of Link elements that you can use to access, remove, disable, or modify
the provider vDC. The new provider vDC becomes a member of the ProviderVdcReferences element of the
VCloud. The resource pool you selected is removed from the resource pool list of the vCenter server.
Chapter 7 Using vCloud API Extensions to Provision and Manage a Cloud
VMware, Inc. 173