4.6.4.1 GET /api/1/machines

GET /api/1/machines returns a list of all of the registered machines. This list includes inactive machines that have uninstalled Uptrack or any machines that have not reported to the Uptrack server recently. The list does not include machines that you have hidden by using the web interface. The response shows a list of machines, which are represented as dictionaries, as shown in the following example:

 {
      hostname: uptrack.example.com,
      ip: 184.73.248.238,
      last_seen: '2010-04-26T18:03:43Z',
      uuid: e82ba0ae-ad0a-4b92-a776-62b502bfd29d,
      active: true,
      status: uptodate,
      authorization: allowed,
      autoinstall: true,
      mmap_min_addr: 4096,
      uptrack_client_version: 1.2.1
   }

The following fields are provided in the response:

status

Contains one of the following values:

outofdate

Additional updates are available for installation on the machine.

unsupported

The machine's kernel is not supported by Ksplice Uptrack.

uptodate

All available updates have been installed on the machine.

authorization

Contains one of the following values:

allowed

The machine is allowed to communicate with the Uptrack servers and to receive updates.

denied

The machine has been denied access to the Uptrack servers via the web interface, uptrack-api-authorize, or the authorize API call.

pending

This account has the default deny policy set for new machines, and the machine has not yet been authorized.

autoinstall

Indicates whether autoinstall is set on the machine.

mmap_min_addr

Is the value of /proc/sys/vm/mmap_min_addr or None for clients prior to version 1.0.3.

uptrack_client_version

Is the version of the Uptrack client that the machine is running.