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 for 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 the value of key is value.
    key != value
        True if the value of key is not value. Equivalent to -key=value and NOT key=value.
    key < value
        True if the value of 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 the value of 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 the value of 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 the value of key is greater than value. If both key and value are numeric then numeric comparison is used, otherwise lexicographic string comparison is used.
    key : value
        True if value contains the value of key using case insensitive string comparison.
    key ~ value
        True if the value of key matches the RE (regular expression) pattern value.
    key !~ value
        True if the value of 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'
List resources with zone prefix us and not MachineType f1-micro:
    $ gcloud compute instances list --filter='zone ~ ^us AND \
        -machineType:f1-micro'