Using filters

You can customize the display of information in the tables according to a given filter. To enter the filter conditions, click in the header of the column with the required parameter.

If a parameter can only assume certain values, you can select one or more values from the list. For example, to display tasks with certain statuses.

An example of a filter for a task list

If the parameter can assume different values, specify the filter conditions using special syntax.

Example of a filter to search by name

Filter syntax

You can use special characters in filters:

Symbol	Meaning	Comment
""	exact query	for text only
*	any number of characters	-
%	any number of characters	-
?	any single character	-
_	any single character	-
&	logical “AND”	-
,	logical “OR”	-
\|	logical “OR”	-
!	logical “NOT”	-
<	smaller than	for numbers only
<=	smaller or equal to	for numbers only
>	greater than	for numbers only
>=	greater or equal to	for numbers only
-	range	for numbers only

Note

Special characters are not used in the following filters:

IP addresses in the VM list;
IP addresses in the list of VMs contained in a high availability cluster;
tags in the script list;
tags in the OS list.

One filter can include several special characters. For example, filter >100&*6 will display all values that are greater than 100 and end in 6.

If you enter a value without special characters in the filter:

for text parameters — the list will be filtered by the occurrence of this value. For example, filter VM1 will display the values of VM1, VM12, My VM1, etc.;
for numeric parameters — the list will be filtered by the exact value. For example, for filter 29, only the value 29 will be displayed.

If symbols for the logical "AND", "OR", "NOT" are inside quotation marks, the filter treats them as normal characters. For example, the filter "drag&drop" will display the drag&drop value.

VM distribution filters

To set a complex VM distribution filter, use the parameters:

Parameter	Meaning	Type
os_tag	OS template tag	text
preset	name of VM configuration	text
cpu_number	vCPU number	number
ram_mib	RAM size, MiB	number
ram_gib	RAM size, GiB	number
hdd_mib	disk size, MiB	number
hdd_gib	disk size, GiB	number

Note

If the text values of the parameters contain spaces, replace them in the filters with _ or ?.

To combine conditions for different parameters, use operators:

Operator	Meaning
&&	logical “AND”
\|\|	logical “OR”

Examples of filters:

(cpu_number > 4 || ram_mib > 2048) && hdd_gib > 100
os_tag = linux|bsd && ram_mib > 1024

Examples of filters

Text values

The platform has six clusters named Cluster1, Cluster2, Cluster12, Cluster13, Cluster22, Cluster34. Examples of filters and filtering results:

Filter	Filtering results
"Cluster1"	Cluster1
Cluster1	Cluster1, Cluster12, Cluster13
*3	Cluster13
Cluster?2	Cluster12, Cluster22
Cluster1\|Cluster2	Cluster1, Cluster2, Cluster12, Cluster13, Cluster22
Cluster&2	Cluster12, Cluster22
!Cluster1	Cluster2, Cluster22, Cluster34
!"Cluster1"	Cluster2, Cluster12, Cluster13, Cluster22, Cluster34

Numerical values

Five virtual machines with the ids of 1, 12, 23, 44, and 45 have been created in the platform. Examples of filters and filtering results:

Filter	Filtering results
12	12
>12	23, 44, 45
1-20	1, 12
4?	44, 45
2	12, 23
!23	1, 12, 44, 45