A host group is a vSphere host DRS group. A vSphere administrator must create host DRS groups in a resource pool mapped to a vCloud Director Provider VDC before they can be used in vCloud Director VM-Host affinity rules.

vSphere host DRS groups created in resource pools that are mapped to a Provider VDC appear in those resource pools and can be named in VM-Host affinity rules. For more information about host DRS groups, see the VMware vSphere ESXi and vCenter Server Documentation.

Host groups are properties of a resource pool.

To retrieve the list of host groups in a resource pool, use a request like the one shown in Example: Host Groups in a Resource Pool

The VMWProviderVdcResourcePoolSet element of a VMWProviderVdc response includes a link of this form.

         type="application/vnd.vmware.admin.vmwHostGroupsType+xml" />

You can make a GET request to this link to list all vSphere host DRS groups created in that resource pool.


GET https://vcloud.example.com/api/admin/extension/resourcePool/83/hostGroups

This response shows a single host DRS group that includes two hosts.


<?xml version="1.0" encoding="UTF-8"?>
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ... >
      <vmext:Hosts type="application/vnd.vmware.admin.vmwHostReferences+xml">
            type="application/vnd.vmware.admin.host+xml" />
            type="application/vnd.vmware.admin.host+xml" />