The VMWProviderVdcResourcePoolSet of a Provider VDC contains information about all of the Provider VDC's resource pools. Getting this information is usually a prerequisite to adding or removing a resource pool.

Each reference in a VMWProviderVdcResourcePoolSet lists the vCenter server that provides the resource pool and indicates whether the resource pool is primary. All resource pools in a VMWProviderVdcResourcePoolSet must come from the same vCenter server.

Prerequisites

This operation is restricted to system administrators.

Procedure

  1. Retrieve the XML representation of the Provider VDC.
    Use a request like this one:
    GET https://vcloud.example.com/api/admin/extension/providervdc/35
  2. Locate the resourcePools link in the VMWProviderVdc.
    Every VMWProviderVdc element includes a link like this one to the Provider VDC's resource pools.
    <Link
         rel="down"
         type="application/vnd.vmware.admin.vmwProviderVdcResourcePoolSet+xml"
         href="https://vcloud.example.com/api/admin/extension/providervdc/35/resourcePools"/>
  3. Retrieve the VMWProviderVdcResourcePoolSet for the Provider VDC.

Example: Retrieve a Resource Pool Set

This example lists the resource pools for the Provider VDC created in Create a Provider VDC Backed by NSX Data Center for vSphere or NSX. The response is a VMWProviderVdcResourcePoolSet that contains two resource pools, one of which is designated primary. Both reference the same vCenter server at https://vcloud.example.com/api/admin/extension/vimServer/9.

Request:
GET https://vcloud.example.com/api/admin/extension/providervdc/35/resourcePools
Response:
200 OK
Content-Type: application/vnd.vmware.admin.vmwprovidervdcresourcepoolset+xml
...
<?xml version="1.0" encoding="UTF-8"?>
<vmext:VMWProviderVdcResourcePoolSet
   xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
   xmlns:vcloud="http://www.vmware.com/vcloud/v1.5" ... >
   <vcloud:Link
      rel="up"
      type="application/vnd.vmware.admin.vmwprovidervdc+xml"
      href="https://vcloud.example.com/api/admin/extension/providervdc/35" />
   <vmext:VMWProviderVdcResourcePool
      primary="true">
      <vcloud:Link
         rel="migrateVms"
         href="https://vcloud.example.com/api/admin/extension/resourcePool/64/action/migrateVms" />
      <vcloud:Link
         rel="resourcePoolVmList"
         href="https://vcloud.example.com/api/admin/extension/resourcePool/64/vmList" />
      <vmext:ResourcePoolVimObjectRef>
         <vmext:VimServerRef
            type="application/vnd.vmware.admin.vmwvirtualcenter+xml"
            name="ConfigWizard Configured vCenter"
            href="https://vcloud.example.com/api/admin/extension/vimServer/9" />
         <vmext:MoRef>resgroup-235</vmext:MoRef>
         <vmext:VimObjectType>RESOURCE_POOL</vmext:VimObjectType>
      </vmext:ResourcePoolVimObjectRef>
      <vmext:ResourcePoolRef
         type="application/vnd.vmware.admin.vmwProviderVdcResourcePool+xml"
         href="https://vcloud.example.com/api/admin/extension/resourcePool/64" />
      <vmext:Enabled>true</vmext:Enabled>
   </vmext:VMWProviderVdcResourcePool>
</vmext:VMWProviderVdcResourcePoolSet>