Ordena y filtra resultados de listas

Cloud Key Management Service es compatible con el filtrado y el ordenamiento de los resultados de las siguientes operaciones de list:

La asistencia para ordenar y filtrar en una operación de list se indica por la presencia de campos de string filter y orderBy en el cuerpo de la solicitud de lista. Ambos campos usan un lenguaje simple para referirse a los campos en el objeto que se ordena o filtra.

Sintaxis de filtro

La sintaxis de filtro consiste en una expresión de uno o más campos del objeto que se filtra.

Puedes usar los siguientes operadores de expresión.

Operador Descripción
= Igualdad
> Superior a
< Inferior a
=> Superior o igual a
<= Inferior o igual a
!=
-
NOT
Desigualdad.
Los siguientes son equivalentes:
name != "quickstart"
-name="quickstart"
NOT name = "quickstart"
: Contención. Esta es una coincidencia de substring con distinción entre mayúsculas y minúsculas.
Como ejemplo, name: "cloud" filtra los recursos que contienen cloud (con distinción entre mayúsculas y minúsculas) en el nombre del recurso.
AND Lógica AND. Un espacio es equivalente a AND, por lo que los siguientes son equivalentes:
name: "cloud" AND name: "kms"
name: "cloud" name: "kms"
OR Lógica OR.

Los operadores AND y OR se aceptan en el mismo nivel de agrupamiento. OR tiene prioridad sobre AND. Puedes usar paréntesis para anular la prioridad predeterminada.

Cuando filtras valores time, codifica la hora como una string en el formato RFC 3399, como 2019-06-20T01:30:15Z.

Cuando accedas a un subcampo, usa la sintaxis de punto. Por ejemplo, el recurso CryptoKey contiene el campo primary. Puedes filtrar los resultados de CryptoKey en el subcampo primary.algorithm para ver un algoritmo específico:

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

Usa la sintaxis de punto para una etiqueta y cualquier otro tipo map:

labels.team=alpha

Una string entre comillas se interpreta como un valor único en lugar de como una secuencia de valores.

Campos filtrables

Puedes filtrar cualquier campo en los objetos que se muestran.

Método de lista Vínculo a los campos filtrables
keyRings.list Campos KeyRing
cryptoKeys.list Campos CryptoKey
cryptoKeyVersions.list Campos CryptoKeyVersion
importJobs.list Campos ImportJob

Sintaxis de orden de clasificación

Puedes ordenar resultados según el campo name del recurso en los objetos. A continuación, se muestran los valores de orden compatibles para el campo orderBy.

Valor Descripción
'' (string vacía) Los resultados se ordenan en el orden predeterminado.
'name' Los resultados se ordenan en orden ascendente según el campo name del recurso.
'name desc' Los resultados se ordenan en orden descendente según el campo name del recurso.