Sintaxis de las consultas

Para buscar elementos, puedes filtrar los resultados de la búsqueda si especificas un FIELD, un operador y un QUERY.

Concordancia exacta del texto: operador igual a (=)

FIELD=QUERY

Una consulta de ejemplo es: policy=amy.2020@gmail.com.

El operador equals (=) verifica que QUERY coincida exactamente con el valor de los metadatos del elemento FIELD. Distingue mayúsculas de minúsculas. En el caso de un campo repetido, si QUERY coincide con uno de los valores del campo, el recurso se considera una coincidencia. Los nombres FIELD admitidos dependen de si la consulta es una búsqueda de recursos o de políticas de Identity and Access Management (IAM). QUERY es una frase, pero no puede contener comodines.

Concordancia parcial de texto: operador de dos puntos (:)

FIELD:QUERY

Una consulta de ejemplo es: policy:amy.2020@gmail.

Cuando se realiza una búsqueda, QUERY se compara con el valor de los metadatos de elementos especificados FIELD. Los campos de consulta y de metadatos del elemento se convierten en una secuencia de palabras (es decir, tokens) para la comparación. Esto se hace de la siguiente manera:

  • Quitar los caracteres especiales iniciales o finales y convertir en token el valor de la búsqueda mediante el trato de los caracteres especiales como delimitadores. Los caracteres especiales de asignación de token son los caracteres que no son uno de los siguientes: [a-zA-Z0-9] alfanuméricos, guiones bajos [_] o et [&].

  • Plegar las mayúsculas y minúsculas de Unicode para que se ignoren las mayúsculas y minúsculas de los caracteres

A continuación, se presentan algunos ejemplos de asignación de token:

  • A "amy-2020@GMAIL.com" se le asigna un token: [amy,2020,gmail,com]

  • A "google.com/cloud" se le asigna un token: [google,com,cloud]

  • A "Compute %Instance%" se le asigna un token: [compute,instance]

  • A "$%^*-!" se le asigna un token: []

  • A "" se le asigna un token: []

  • A "compute*storage" se le asigna un token: [compute,storage]

  • A "compute&storage" se le asigna un token: [compute&storage]

  • A "BOB_test@gmail.com" se le asigna un token: [bob_test,gmail,com]

  • A "instance/_my_vm_" se le asigna un token: [instance,_my_vm_]

El operador has (:) verifica que cada palabra de QUERY exista en el valor del campo de metadatos del activo. También verifica el orden y la consecutividad de las palabras. La FIELD compatible puede ser diferente, según si se trata de una búsqueda de recursos o de políticas de IAM. QUERY puede ser una frase o una combinación de frases.

Ejemplos

Por ejemplo, un recurso cuyo campo policy tiene el valor amy.2020@gmail.com coincide con las siguientes consultas:

  • Coincide porque la frase es exactamente la misma que el valor del campo.
policy=amy.2020@gmail.com
  • Coincide porque los caracteres de puntuación se tratan como delimitadores y la consulta no distingue mayúsculas de minúsculas.
policy:amy-2020@GMAIL.com
  • Coincide porque las palabras de una frase concuerda con el orden. Ten en cuenta que "amy 2020 gmail" es una frase; las palabras deben coincidir en orden y de forma consecutiva.
policy:"amy 2020 gmail"
  • Coincide porque una combinación de palabras puede aparecer en cualquier orden. Ten en cuenta que (gmail 2020 amy) es una combinación; las palabras coinciden, pero no necesariamente según el orden.
policy:(gmail 2020 amy)
  • Coincide porque las palabras de la frase concuerdan según el orden y las palabras de la combinación aparecen en cualquier orden. Ten en cuenta que "amy 2020" es una frase y las palabras deben coincidir en orden y de forma consecutiva. (gmail "amy 2020") es una combinación; gmail y "amy 2020" coinciden, y no necesariamente según el orden.
policy:(gmail "amy 2020")
  • Coincide porque * se puede usar en una frase para indicar una coincidencia de prefijo.
policy:amy-20*

Un recurso cuyo campo policy tiene el valor "amy.2020@gmail.com" NO coincide con las siguientes consultas:

  • No coincide porque la frase distingue mayúsculas de minúsculas. En su lugar, usa el operador has (:) para la coincidencia que no distingue entre mayúsculas y minúsculas.
policy=amy.2020@GMAIL.com
  • No coincide porque la frase coincide de forma parcial con el valor del campo. En su lugar, usa el operador has (:) para la coincidencia parcial.
policy=amy.2020@gmail

Coincidencia numérica: operadores de comparación (=, >, >=, <, <=)

FIELD=QUERY

FIELD>QUERY

FIELD>=QUERY

FIELD<QUERY

FIELD<=QUERY

Los operadores de comparación verifican que el resultado de la comparación entre QUERY y el valor de los metadatos del elemento FIELD sea verdadero.

Los nombres de FIELD compatibles incluyen createTime y updateTime.

Para los campos de marca de tiempo (createTime y updateTime), el QUERY podría ser un número entero firmado de 64 bits, que representa la marca de tiempo de época en segundos, o una string de fecha y hora en uno de los siguientes formatos (la zona horaria es UTC):

  • AAAA-MM-DD: 2021-01-01 (las comillas son opcionales)

  • “AAAA-MM-DDThh:mm:ss”: “2021-01-01T00:00:00” (se requieren comillas)

Ejemplos

Por ejemplo, un recurso cuyo campo createTime tiene el valor 1609459200 (marca de tiempo de la época de 2021-01-01T00:00:00) coincide con las siguientes consultas:

Es igual a

createTime=1609459200
createTime=2021-01-01
createTime="2021-01-01T00:00:00"

Superior a

createTime>1500000000
createTime>2020-01-01
createTime>"2020-01-01T00:00:00"

Mayor o igual que.

createTime>=1609459200
createTime>=2021-01-01
createTime>="2021-01-01T00:00:00"

Inferior a

createTime<1700000000
createTime<2022-01-01
createTime<"2022-01-01T00:00:00"

Menor o igual que.

createTime<=1609459200
createTime<=2021-01-01
createTime<="2021-01-01T00:00:00"

Frase

Una frase es una o varias palabras entre comillas dobles ("). En el caso de las frases, el orden de las palabras es importante. Las palabras en la frase deben coincidir en orden y de forma consecutiva. Ten en cuenta que, para hacer coincidir varias palabras sin respetar el orden, debes usar la combinación (por ejemplo, field:(word1 word2 word3)).

Las siguientes expresiones son las mismas:

policy:amy
policy:"amy"

policy:amy.2020@gmail.com
policy:"amy.2020@gmail.com"

name://cloudresourcemanager.googleapis.com/projects/projects/foo-bar
name:"//cloudresourcemanager.googleapis.com/projects/projects/foo-bar"

Las siguientes frases deben ir entre comillas:

name:"my instance"

policy:"amy%2020@gmail.com"

description:"domain:gmail.com"

description:"hello \"world\""

description:"hello\\world"

Ejemplos: frase

  • Muestra los elementos cuyo campo policy tiene la palabra amy y la palabra 2020 en orden y, de manera consecutiva:

    policy:"amy 2020"
    
  • Si tienes un recurso cuyo valor de campo policy es "amy.2020@gmail.com", coincidirá con la consulta anterior.

  • Si tienes un recurso cuyo valor de campo policy es "2020.amy@gmail.com", la consulta anterior no coincidirá, ya que las palabras no coinciden en orden.

  • Si tienes un recurso cuyo valor de campo policy es "amy.us.2020@gmail.com", la consulta anterior no coincidirá, ya que las palabras no coinciden consecutivamente.

Combinación

Las frases de búsqueda se pueden combinar con AND o OR. Los paréntesis se usan para agrupar combinaciones.

Ejemplos: combinación

  • Muestra los elementos cuyo campo policy tiene la palabra amy y la palabra john, sin respetar el orden. AND es opcional en una combinación. Ten en cuenta que, para que coincidan varias palabras en orden, debes usar la frase (por ejemplo, field:"word1 word2 word3").

    owner:(amy john)
    
  • Muestra los elementos cuyo campo policy contenga la palabra amy o la palabra john.

    policy:(amy OR john)
    
  • Muestra los elementos cuyo campo policy contenga tanto la palabra amy como la palabra john, o bien la palabra bob.

    policy:((amy john) OR bob)
    
  • Muestra los elementos cuyo campo policy contenga la palabra amy y la palabra john o el campo name contenga la palabra bob.

    policy:(amy john) OR name:bob
    

Filtros de búsqueda de negación

Los filtros de búsqueda se pueden negar con el operador NOT. Los paréntesis son compatibles, pero no obligatorios.

Ejemplos: Anular filtros de búsqueda

  • Muestra los elementos cuyo campo state no contengan la palabra ACTIVE.

    NOT state:ACTIVE
    
  • Muestra los elementos cuyo campo policy no contenga la palabra amy ni la palabra john.

    NOT policy:(amy OR john)
    
  • Muestra los elementos cuyos campos networkTags no contengan la palabra internal ni private.

    NOT (networkTags:internal OR networkTags:private)
    

Comodín

Los asteriscos (*) se pueden usar en una frase como carácter comodín. Según su posición, puede tener diferentes significados.

  • Si está al final de una frase, por ejemplo, "am 20*", es un indicador de coincidencia de prefijo del token. La consulta es equivalente a (am* 20*). Coincide con el campo que contiene un token que comienza con “am”, por ejemplo, “amy”, y un token que comienza con “20”, por ejemplo, “2021”. No importa el orden de los prefijos.

  • Si la frase completa solo contiene una *, por ejemplo, "labels.env:*", realiza una verificación de existencia. Verifica si la clave de etiqueta “env” dada existe. No se admiten otros campos.

  • Si está en medio de una frase, por ejemplo, "compute*storage", se trata como un delimitador de asignación de token. La consulta es equivalente a “almacenamiento de procesamiento”.

  • Si está al principio y al final de una frase, por ejemplo, "*compute storage*", se trata como un delimitador de asignación de token. La consulta es equivalente a “almacenamiento de procesamiento”.

Ejemplos: coincidencia de prefijo de token

  • Muestra elementos cuyo campo policy contenga una palabra que comience con am:

    policy:am*
    
  • Muestra los elementos cuyos campos policy contengan dos palabras con "amy" y "20" como prefijos:

    policy:"amy 20*"
    
    policy:"20 amy*"
    
  • Si tienes un recurso cuyo valor de campo policy es "amy.2020@gmail.com", ambas consultas anteriores coincidirán. Después de la asignación de token, tanto "amy" como "20" son prefijos. Ten en cuenta que la string de consulta "amy 20*" es diferente de "amy 20". Esta última requiere que 20 sea una palabra completa que no sea un prefijo.

Ejemplo: existencia de la clave de etiqueta

Muestra los elementos cuyo labels tiene “env” como clave y tiene cualquier valor (incluidos un valor vacío o ningún valor):

labels.env:*