Interactive search

See Web UI for how to get started with the web UI.

The Machines and Devices pages contain a powerful interactive search bar that lets you filter machines and devices.

Simple searches

To begin searching, simply enter the text you're interested in. As you type, MAAS will update search results in real time. You can search across virtually every parameter, including domain, name, tag, power type, IP, status, zone, and so on.

searchbar

Filtered searches

Filter your searches to major categories by selecting one from the Filters dropdown menu next to the search bar.

filters

For example, to find all "New" machines containing the name or tag 'quail', select Status/New from the dropdown Filters menu, and then type the word 'quail' next to it:

filterresult

Manual filters

Enter filters manually in the search bar to more precisely control your searches:

filter-name:([=]val1,...,[=]val2)

Note: Parentheses surrounding the value list are only necessary when a value has a space and might be misinterpreted as the start of an additional search term. E.g. status:(failed testing).

Exact matching

If you need an exact match, preface the search value with an equal sign. For example, to find machines belonging to a pod named able-cattle:

pod:=able-cattle

Partial matching

Without an equal sign, MAAS returns partial matches. For example, the following will display all machines belonging to pods with names containing able or cattle:

pod:able,cattle

Multiple search terms

MAAS uses boolean AND logic to evaluate multiple search terms. That is, when you provide multiple search terms, e.g. pod:able,cattle cpu:=5, MAAS displays machines that belong to pods with names containing able OR cattle AND having 5 CPU cores. Similarly, if you provide multiple string searches, steady able, MAAS will display machines matching steady AND able.

Filter properties

In addition to the major filtering categories available in the Filter dropdown menu, the following machine properties are available as filters:

  • architecture
  • cores
  • cpu
  • distro_series
  • fqdn
  • ip_addresses
  • mac
  • pod
  • pod-id
  • pool
  • power
  • pxe_mac
  • pxe_mac_vendor
  • ram
  • release
  • spaces
  • status
  • storage
  • storage_tags
  • tags
  • zone

For example, the following will search for a machine that has an interface with a specific MAC address marked for PXE booting:

pxe_mac:=9e:b0:e4:15:ae:1e

CLI

See List nodes for more information about how to use the MAAS CLI to perform similar searches or CLI for how to get started with the MAAS CLI.