GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GCLOUD_TOPIC_FILTERS (1)

NAME

gcloud topic filters - resource filters supplementary help

CONTENTS

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’
Search for    or go to Top of page |  Section 1 |  Main Index


GCLOUD_TOPIC_FILTERS (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.