General filter string syntax:
<field> <operator> <value> (<logical connector>)
<field> can be name, address, port, or annotations.<key> for
map field
<operator> can be <, >, <=, >=, !=, =, :. Of which :
means HAS, and is roughly the same as =
<value> must be the same data type as field
<logical connector> can be AND, OR, NOT
Examples of valid filters:
annotations.owner returns endpoints that have a annotation with the
key owner, this is the same as annotations:owner
annotations.protocol=gRPC returns endpoints that have key/value
protocol=gRPC
address=192.108.1.105 returns endpoints that have this address
port>8080 returns endpoints that have port number larger than 8080
*
name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c
returns endpoints that have name that is alphabetically later than the
string, so "endpoint-e" is returned but "endpoint-a" is not
annotations.owner!=sd AND annotations.foo=bar returns endpoints that
have owner in annotation key but value is not sd AND have
key/value foo=bar
doesnotexist.foo=bar returns an empty list. Note that endpoint
doesn't have a field called "doesnotexist". Since the filter does not
match any endpoints, it returns no results
For more information about filtering, see
API Filtering.
General filter string syntax:
<field> <operator> <value> (<logical connector>)
<field> can be name, address, port, or annotations.<key> for
map field
<operator> can be <, >, <=, >=, !=, =, :. Of which :
means HAS, and is roughly the same as =
<value> must be the same data type as field
<logical connector> can be AND, OR, NOT
Examples of valid filters:
annotations.owner returns endpoints that have a annotation with the
key owner, this is the same as annotations:owner
annotations.protocol=gRPC returns endpoints that have key/value
protocol=gRPC
address=192.108.1.105 returns endpoints that have this address
port>8080 returns endpoints that have port number larger than 8080
*
name>projects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service/endpoints/endpoint-c
returns endpoints that have name that is alphabetically later than the
string, so "endpoint-e" is returned but "endpoint-a" is not
annotations.owner!=sd AND annotations.foo=bar returns endpoints that
have owner in annotation key but value is not sd AND have
key/value foo=bar
doesnotexist.foo=bar returns an empty list. Note that endpoint
doesn't have a field called "doesnotexist". Since the filter does not
match any endpoints, it returns no results
For more information about filtering, see
API Filtering.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-01-27 UTC."],[],[]]
