Locating and searching for machines
Master the MAAS search bar
This guide helps you leverage the search bar in the Machines and Devices pages of MAAS to filter your resources effectively.
What you'll learn:
- Simple searches
- Filtered searches
- Creating manual filters
- Exact and partial matching
- Using multiple search terms
We also offer a filter properties reference.
Constructing a MAAS search parameter
Here's how a typical MAAS search parameter looks:
Search attributes go into the Search box, separated by spaces for 'AND' logic, or enclosed in parentheses and divided by commas for 'OR' logic. They generally follow the format parameter-name:. You can fine-tune matches using '=' for exact and '!' for negations. The UI filter drop-downs also help you understand how these work.
- Go to Machines.
- Type your search term in the Search box. MAAS updates results as you type, and you can search across many parameters.
- Go to Machines.
- Open the Filters drop-down.
- Pick a parameter group, which stays open.
- Choose parameter values; MAAS updates results immediately.
You can enter manual filters in the search bar:
filter-name:([=]val1,...,[=]val2)
Note: Enclose terms in parentheses for group searches, like
status:(failed testing).
For exact matches, prefix the search value with '='. For partial matches, omit it. For example:
Exact: pod:=able-cattle
Partial: pod:able,cattle
MAAS uses 'AND' logic by default for multiple terms. For instance, pod:able,cattle cpu:=5 will show machines in pods named able or cattle with 5 CPU cores.
Here's a comprehensive table of filter properties you can use. 'Dyn' means dynamic, 'Grp' for groupable, and 'Man' for manually entered.
| Parameter (bold) w/example | Shows nodes... | Dyn | Grp | Man |
|---|---|---|---|---|
| arch:(=architecture) | with "architecture" | Grp | ||
| arch:(!=architecture) | NOT with "architecture" | Dyn | ||
| zone:(=zone-name) | in "zone-name" | Dyn | Grp | |
| zone:(!=zone-name) | NOT in "zone-name" | Dyn | ||
| pool:(=resource-pool) | in "resource-pool" | Dyn | Grp | |
| pool:(!=resource-pool) | NOT in "resource-pool" | Dyn | ||
| pod:(=pod-name) | with "pod-name" | Dyn | Grp | |
| pod:(!=pod-name) | NOT with "pod-name" | Dyn | ||
| pod_type:(=pod-type) | with power type "pod-type" | Dyn | Grp | Man |
| pod_type:(!=pod-type) | NOT with power type "pod-type" | Dyn | Man | |
| domain:(=domain-name) | with "domain-name" | Dyn | Grp | Man |
| domain:(!=domain-name) | NOT with "domain-name" | Dyn | Man | |
| status:(=op-status) | having "op-status" | Grp | ||
| status:(!=op-status) | NOT having "op-status" | Dyn | ||
| owner:(=user) | owned by "user" | Dyn | Grp | |
| owner:(!=user) | NOT owned by "user" | Dyn | ||
| power_state:(=power-state) | having "power-state" | Grp | Man | |
| power_state:(!=power-state) | NOT having "power-state" | Dyn | Man | |
| tags:(=tag-name) | with tag "tag-name" | Dyn | ||
| tags:(!=tag-name) | NOT with tag "tag-name" | Dyn | ||
| fabrics:(=fabric-name) | in "fabric-name" | Dyn | ||
| fabrics:(!=fabric-name) | NOT in "fabric-name" | Dyn | ||
| fabric_classes:(=fabric-class) | in "fabric-class" | Dyn | Man | |
| fabric_classes:(!=fabric-class) | NOT in "fabric-class" | Dyn | Man | |
| fabric_name:(=fabric-name) | in "boot-interface-fabric" | Dyn | Man | |
| fabric_name:(!=fabric-name) | NOT in "boot-interface-fabric" | Dyn | Man | |
| subnets:(=subnet-name) | attached to "subnet-name" | Dyn | ||
| subnets:(!=subnet-name) | Not attached to "subnet-name" | Dyn | ||
| link_speed:(link-speed) | having "link-speed" | Dyn | Man | |
| link_speed:(!link-speed) | NOT having "link-speed" | Dyn | Man | |
| vlans:(=vlan-name) | attached to "vlan-name" | Dyn | ||
| vlans:(!=vlan-name) | NOT attached to "vlan-name" | Dyn | ||
| storage:(storage-MB) | having "storage-MB" | Dyn | Man | |
| total_storage:(total-stg-MB) | having "total-stg-MB" | Dyn | Man | |
| total_storage:(!total-stg-MB) | NOT having "total-stg-MB" | Dyn | Man | |
| cpu_count:(cpu-count) | having "cpu-count" | Dyn | Man | |
| cpu_count:(!cpu-count) | NOT having "cpu-count" | Dyn | Man | |
| mem:(ram-in-MB) | having "ram-in-MB" | Dyn | Man | |
| mem:(!ram-in-MB) | NOT having "ram-in-MB" | Dyn | Man | |
| mac_address:(=MAC) | having MAC address "MAC" | Dyn | Man | |
| mac_address:(!=MAC) | NOT having | Dyn | Man | |
| agent_name:(=agent-name) | Include nodes with agent-name | Dyn | Man | |
| agent_name:(!=agent-name) | Exclude nodes with agent-name | Dyn | Man | |
| cpu_speed:(cpu-speed-GHz) | CPU speed | Dyn | Man | |
| cpu_speed:(!cpu-speed-GHz) | CPU speed | Dyn | Man | |
| osystem:(=os-name) | The OS of the desired node | Dyn | Man | |
| osystem:(!=os-name) | OS to ignore | Dyn | Man | |
| distro_series:(=distro-name) | Include nodes using distro | Dyn | Man | |
| distro_series:(!=distro-name) | Exclude ndoes using distro | Dyn | Man | |
| ip_addresses:(=ip-address) | Node's IP address | Dyn | Man | |
| ip_addresses:(!=ip-address) | IP address to ignore | Dyn | Man | |
| spaces:(=space-name) | Node's spaces | Dyn | ||
| spaces:(!=space-name) | Node's spaces | Dyn | ||
| workloads:(=annotation-text) | Node's workload annotations | Dyn | ||
| workloads:(!=annotation-text) | Node's workload annotations | Dyn | ||
| physical_disk_count:(disk-count) | Physical disk Count | Dyn | Man | |
| physical_disk_count:(!disk-count) | Physical disk Count | Dyn | Man | |
| pxe_mac:(=PXE-MAC) | Boot interface MAC address | Dyn | Man | |
| pxe_mac:(!=PXE-MAC) | Boot interface MAC address | Dyn | Man | |
| fqdn:(=fqdn-value) | Node FQDN | Dyn | Man | |
| fqdn:(!=fqdn-value) | Node FQDN | Dyn | Man | |
| simple_status:(=status-val) | Include nodes with simple-status | Dyn | Man | |
| simple_status:(!=status-val) | Exclude nodes with simple-status | Dyn | Man | |
| devices:(=) | Devices | Dyn | Man | |
| interfaces:(=) | Interfaces | Dyn | Man | |
| parent:(=) | Parent node | Dyn | Grp | Man |