2.3. List Host Cluster Collection

Red Hat Enteprise Virtualization Manager creates a Default host cluster on installation. This example uses the Default cluster to group virtual machines in your Red Hat Enteprise Virtualization environment.

The following request retrieves a representation of the cluster collection:

Example 2.3. List host clusters collection

GET /rhevm-api/clusters HTTP/1.1
Accept: application/xml

The API returns the following representation:

HTTP/1.1 200 OK
Content-Type: application/xml

<clusters>
    <cluster id="99408929-82cf-4dc7-a532-9d998063fa95"
      href="/rhevm-api/clusters/99408929-82cf-4dc7-a532-9d998063fa95">
        <name>Default</name>
        <description>The default server cluster</description>
        <link rel="networks"
          href="/rhevm-api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks"/>
        <link rel="permissions"
          href="/rhevm-api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/permissions"/>
        <cpu id="Intel Penryn Family"/>
        <data_center id="01a45ff0-915a-11e0-8b87-5254004ac988"
          href="/rhevm-api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988"/>
        <memory_policy>
            <overcommit percent="100"/>
            <transparent_hugepages>
                <enabled>false</enabled>
            </transparent_hugepages>
        </memory_policy>
        <scheduling_policy/>
        <version minor="0" major="3"/>
        <error_handling>
            <on_error>migrate</on_error>
        </error_handling>
    </cluster>
</clusters>

Note the id code of your Default host cluster. This code indentifies this host cluster in relation to other resources of your virtual environment.

The Default cluster is associated with the Default data center through a relationship using the data center's id code.

The networks sub-collection contains a list of associated network resources for this cluster. The next section examines the networks collection in more detail.