C.2.2. Searching for Hosts

The following table describes all search options for hosts.
Property (of resource or resource-type) Type Description (Reference)
Events.events-prop See property types in Section C.2.5, “Searching for Events” The property of the Events associated with the host.
Users.users-prop See property types in Section C.2.4, “Searching for Users” The property of the Users associated with the host.
name String The name of the host.
status List The availability of the host.
cluster String The cluster to which the host belongs.
address String The unique name that identifies the host on the network.
cpu_usage Integer The percent of processing power used.
mem_usage Integer The percentage of memory used.
network_usage Integer The percentage of network usage.
load Integer Jobs waiting to be executed in the run-queue per processor, in a given time slice.
version Integer The version number of the operating system.
cpus Integer The number of CPUs on the host.
memory Integer The amount of memory available.
cpu_speed Integer The processing speed of the CPU.
cpu_model String The type of CPU.
committed_mem Integer The percentage of committed memory.
tag String The tag assigned to the host.
type String The type of host.
sortby List Sorts the returned results by one of the resource properties.
page Integer The page number of results to display
Example
Host: cluster = Default
returns a list of hosts which:
  • Are part of the Default cluster.