The Machines and Devices pages contain a powerful interactive search bar that lets you filter machines and devices. This article is designed to help you understand how to use this resource.
This article will explain:
- How to do simple searches
- How to do filtered searches
- How to create manual filters
- How to set up exact matching
- How to set up partial matching
- How to include multiple search terms
This article also includes a filter properties reference
To begin searching, enter your search text. 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.
Filter your searches to major categories by selecting one from the Filters drop-down menu next to the search bar.
For example, to find all “New” machines containing the name or tag ‘quail’, select Status/New from the drop-down Filters menu, and then type the word ‘quail’ next to it:
Enter filters manually in the search bar to more precisely control your searches:
Note: Surround search terms with parentheses when they must occur together, e.g.,
How to set up 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
Without an equal sign, MAAS returns partial matches. For example, the following will display all machines belonging to pods with names containing
MAAS uses Boolean AND logic to evaluate multiple search terms. For example, when you type
pod:able,cattle cpu:=5, MAAS displays machines that belong to pods with names containing
cattle AND having 5 CPU cores. Similarly, if you enter multiple words into the search tool, e.g.,
steady able, MAAS will display machines matching both terms (e.g.,
In addition to the major filtering categories available in the Filter drop-down menu, the following machine properties are available as filters:
1. architecture 2. cores 3. cpu 4. distro_series 5. fqdn 6. ip_addresses 7. mac 8. pod 9. pod-id 10. pool 11. power 12. pxe_mac 13. pxe_mac_vendor 14. ram 15. release 16. spaces 17. status 18. storage 19. storage_tags 20. tags 21. zone
For example, the following will search for a machine that has an interface with a specific MAC address marked for PXE booting: