2.10. Searching for Hosts
The following table describes all search options for hosts.
Table 2.6. Searching for Hosts
| Property (of resource or resource-type) | Type | Description (Reference) |
|---|---|---|
|
| Depends on property type | The property of the virtual machines associated with the host. |
|
| Depends on property type | The property of the templates associated with the host. |
|
| Depends on property type | The property of the events associated with the host. |
|
| Depends on property type | The property of the users associated with the host. |
|
| String | The name of the host. |
|
| List | The availability of the host. |
|
| String | The health status of the host as reported by external systems and plug-ins. |
|
| String | The cluster to which the host belongs. |
|
| String | The unique name that identifies the host on the network. |
|
| Integer | The percent of processing power used. |
|
| Integer | The percentage of memory used. |
|
| Integer | The percentage of network usage. |
|
| Integer | Jobs waiting to be executed in the run-queue per processor, in a given time slice. |
|
| Integer | The version number of the operating system. |
|
| Integer | The number of CPUs on the host. |
|
| Integer | The amount of memory available. |
|
| Integer | The processing speed of the CPU. |
|
| String | The type of CPU. |
|
| Integer | The number of virtual machines currently running. |
|
| Integer | The number of virtual machines currently being migrated. |
|
| Integer | The percentage of committed memory. |
|
| String | The tag assigned to the host. |
|
| String | The type of host. |
|
| String | The data center to which the host belongs. |
|
| List | Sorts the returned results by one of the resource properties. |
|
| Integer | The page number of results to display. |
Example
Hosts: cluster = Default and Vms.os = rhel6
This example returns a list of hosts which are part of the Default cluster and host virtual machines running the Red Hat Enterprise Linux 6 operating system.

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.