GCLOUD_TOPIC_FILTERS(1)

NAME

gcloud topic filters - resource filters supplementary help

DESCRIPTION
Most gcloud commands return a list of resources on success. By default they are pretty-printed on the standard output. The --format=NAME[ATTRIBUTES](PROJECTION) flag changes the default output: NAME
    The format name.
ATTRIBUTES
    Format specific attributes. For details run $ gcloud topic formats.
PROJECTION
    A list of resource keys that selects the data listed. For details run $ gcloud topic projections.
resource keys
    Keys are names for resource resource items. For details run $ gcloud topic resource-keys. Most gcloud list commands have a --filter=EXPRESSION flag that selects resources to be listed. Resource filters are described in detail below.

Filter Expressions
A filter expression is a Boolean function that selects resources from a list. Expressions are composed of terms connected by logic operators. LogicOperator
    Expressions containing both AND and OR must be parenthesized to disambiguate precedence. NOT term-1
        True if term-1 is False, otherwise False.
    term-1 AND term-2
        True if both term-1 and term-2 are true.
    term-1 OR term-2
        True if at least one of term-1 or term-2 is true.
    term-1 term-2
        True if both term-1 and term-2 are true. Implicit conjunction has lower precedence than OR.
Terms
    A term is a key operator value tuple, where key is a dotted name that evaluates to the value of a resource attribute, and value may be: number
        integer or floating point numeric constant
    unquoted literal
        character sequence terminated by space, ( or )
    quoted literal
        "..." or '...' Most filter expressions need to be quoted in shell commands. If you use '...' shell quotes then use "..." filter string literal quotes and vice versa.
Operator Terms
    key = value
        True if key is equal to value.
    key =( value ... )
        True if key is equal to any value in the (space, tab, newline, ,) separated list.
    key != value
        True if key is not value. Equivalent to -key=value and NOT key=value.
    key < value
        True if key is less than value. If both key and value are numeric then numeric comparison is used, otherwise lexicographic string comparison is used.
    key <= value
        True if key is less than or equal to value. If both key and value are numeric then numeric comparison is used, otherwise lexicographic string comparison is used.
    key >= value
        True if key is greater than or equal to value. If both key and value are numeric then numeric comparison is used, otherwise lexicographic string comparison is used.
    key > value
        True if key is greater than value. If both key and value are numeric then numeric comparison is used, otherwise lexicographic string comparison is used.
    key : simple-pattern
        True if key matches simple-pattern. The match is anchored (all characters must match), case insensitive, and allows one * operator that matches any sequence of 0 or more characters. The pattern abc matches abc, the pattern abc* matches abc and abcxyz, the pattern *xyz matches xyz and abcxyz, and the pattern * matches any non-empty string.
    key :( simple-pattern ... )
        True if key matches any simple-pattern in the (space, tab, newline, comma) separated list.
    key ~ value
        True if key matches the RE (regular expression) pattern value.
    key !~ value
        True if key does not match the RE (regular expression) pattern value.

EXAMPLES
List all instances resources:
    $ gcloud compute instances list
List instances resources that have machineType f1-micro:
    $ gcloud compute instances list --filter='machineType:f1-micro'
List resources with zone prefix us and not MachineType f1-micro:
    $ gcloud compute instances list \
        --filter='zone ~ ^us AND -machineType:f1-micro'