Cloud Manager includes a search tool at the top of the dashboard which can be used to search for a large number of active services on your account, including Compute Instances, Volumes, NodeBalancers, Domains, Tags, and more.

This guide covers the capabilities of this search tool so that you and your team can leverage it to find and access your resources quickly and efficiently.

Standard search

A standard search without the use of any keywords or operators defaults to searching for active labels, tags, and IP addresses. In the following example, the search for the string "production" is used to pull up all of the resources which match this string, including both tags and labels.

This kind of search is sufficient if you only have a few resources. However, if you have a large number of resources, the number of returned values can become difficult to parse. The following, more advanced tools, can be more helpful in these situations.

Keywords

The search tool can also be used with keywords to help filter and refine the results. Here is a list of common keywords and their definitions:

The syntax for using keywords is:

keyword:string defined by the keyword to limit your search

For example, to search for all images on your account, you would enter the following:

type:image

To find all applicable resources created in the year 2020:

created:2020

You can make this more focused by combining the standard search with the keywords. For example, the following query searches for NodeBalancers with the label or tag ecommerce:

type:NodeBalancer ecommerce

Standard logical operators

Cloud Manager includes support for standard logical operators OR, AND, and - (NOT) which can help to filter the results of your search further.

Or

OR can be used to search for multiple different keywords in a single query. For example, use the following query to display all Compute Instances and Images on your account:

type:linode OR type:image

And

AND will allow you to narrow your search more precisely for additional qualifiers. The following search finds all of the Compute Instances which also match the production tag:

type:linode AND tag:production

Not

The NOT, or negate, operator is used by preceding the keyword with a - symbol. A negate operator can be used to return all values that are NOT defined by the negate operator. For example, this query will return everything except Compute Instances:

-type:linode

Aliases

Some operators and keywords include one or more aliases that you can use as an alternative to standard usage. Aliases and their standard equivalent(s) are in the chart below.

Nested queries

You can nest queries using parentheses for an even higher level of control. For example, if you want to search for all of your domains created in 2010, as well as all of your Compute Instances that match the tag my-tag, you can use the following nested query:

(type:domain AND created:2010) OR (type:linode AND tag:my-tag)

Combining queries

The most robust functionality of the search tool can be used by combining and grouping queries to create compound queries. For example, you can see all of the advanced features outlined in this guide in a single query:

type:linode AND -group:production || (type:NodeBalancer && tag:mytag)

Invalid search results

If you search for an invalid keyword, a string that doesn't match a keyword like an invalid status, or a search that comes up empty, Cloud Manager displays an error screen.