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 el ordenamiento y el filtrado en una operación de list se indica mediante la presencia de los 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, los filtros name: "cloud" en los recursos que contienen cloud (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 de time, codifica el tiempo 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 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 nombre del recurso de los objetos. A continuación, se muestran los valores de orden de clasificación 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 nombre del recurso.
'name desc' Los resultados se ordenan en orden descendente según el nombre del recurso.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...