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.

<vcloud:Link
         rel="down"
         href="https://vcloud.example.com/api/admin/extension/resourcePool/id/hostGroups"
         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.

Request:

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

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

Response:

<?xml version="1.0" encoding="UTF-8"?>
<vmext:VMWHostGroups
   xmlns:vmext="http://www.vmware.com/vcloud/extension/v1.5"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ... >
   <vmext:HostGroup>
      <vmext:HostGroupName>HostGroup-MSSQL</vmext:HostGroupName>
      <vmext:Hosts type="application/vnd.vmware.admin.vmwHostReferences+xml">
         <vmext:HostReference
            href="https://vcloud.example.com/api/admin/extension/host/95"
            name="ESXi37"
            type="application/vnd.vmware.admin.host+xml" />
         <vmext:HostReference
            href="https://vcloud.example.com/api/admin/extension/host/28"
            name="ESXi39"
            type="application/vnd.vmware.admin.host+xml" />
      </vmext:Hosts>
   </vmext:HostGroup>
</vmext:VMWHostGroups>