You can merge one or more Provider vDCs with an existing Provider vDC. The merged Provider vDC contains the union of all resources from the contributing Provider vDCs

In earlier releases of vCloud Director, a Provider vDC could be backed by no more than one resource pool. This release removes that limitation, and allows you to merge existing Provider vDCs to create a single Provider vDC that is backed by multiple resource pools. When you merge Provider vDCs, you select one or more Provider vDCs as contributors and one Provider vDC as the target of the merge. When the merge is complete:

The target Provider vDC includes the networks, network pools, storage profiles, resource pools, and datastores from all of the contributors.

Organization vDCs that were backed by the contributors are now backed by the target.

Verify that you are logged in to the vCloud API as a system administrator.

1

Identify the Provider vDCs to merge.

Select contributors that are not backed by the same resource pool as the target. You can use a query like this one to discover the resource pools backing each of your Provider vDCs.

GET https://vcloud.example.com/api/query?type=providerVdcResourcePoolRelation&format=records
2

Construct a ProviderVdcMergeParams element that references each of the contributor provider vDCs.

See the request portion of Example: Merge Provider vDCs.

3

Make a POST request to the action/merge link of the target Provider vDC and supply the ProviderVdcMergeParams as the request body.

This request includes a ProviderVdcReference for each of two contributors. The request URL specifies the target Provider vDC.

Request:

POST https://vcloud.example.com/api/admin/extension/providervdc/35/action/merge
Content-Type: application/vnd.vmware.admin.providerVdcMergeParams+xml
...
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<vmext:ProviderVdcMergeParams
   type="application/vnd.vmware.admin.mergeParams+xml"
   xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
   xmlns:vcloud="http://www.vmware.com/vcloud/v1.5">
   <vmext:ProviderVdcReference
      type="application/vnd.vmware.admin.vmwprovidervdc+xml"
      name="PvDC-VC001"
      href="https://vcloud.example.com/api/admin/extension/providervdc/46" />
   <vmext:ProviderVdcReference
      type="application/vnd.vmware.admin.vmwprovidervdc+xml"
      name="PvDC-VC005"
      href="https://vcloud.example.com/api/admin/extension/providervdc/45" />
</vmext:ProviderVdcMergeParams>

Response:

202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... >
   ...
</Task>