Como classificar e filtrar resultados da lista

O Cloud Key Management Service aceita resultados de filtragem e armazenamento das seguintes operações de list.

O suporte para classificação e filtragem em uma operação de list é indicado pela presença de campos de string filter e orderBy no corpo da solicitação de lista. Ambos os campos usam um idioma simples para se referir aos campos no objeto que está sendo classificado e/ou filtrado.

Sintaxe do filtro

A sintaxe do filtro consiste em uma expressão em um ou mais campos dos objetos que estão sendo filtrados.

Você pode usar os seguintes operadores de expressão.

Operador Descrição
= Igual a
> Maior que
< Menor que
=> Maior que ou igual a
<= Menor que ou igual a
!=
-
NOT
Diferente de
Os seguintes são equivalentes:
name != "quickstart"
-name="quickstart"
NOT name = "quickstart"
: Contenção. Essa é uma correspondência de substring que não diferencia maiúsculas de minúsculas.
Como exemplo, name: "cloud" filtra recursos que contêm cloud (não diferencia maiúsculas de minúsculas) no nome do recurso.
AND "E" lógico. Um espaço é equivalente a AND, então os seguintes são equivalentes:
name: "cloud" AND name: "kms"
name: "cloud" name: "kms"
OR "OU" lógico.

Os operadores AND e OR são aceitos no mesmo nível de agrupamento. OR tem precedência sobre AND. Use parênteses para substituir a precedência padrão.

Ao filtrar valores de time, codifique o tempo como uma string no formato RFC 3399, como 2019-06-20T01:30:15Z.

Ao acessar um subcampo, use a sintaxe de ponto. Por exemplo, o recurso CryptoKey contém o campo primary. Você pode filtrar os resultados de CryptoKey no subcampo primary.algorithm para um algoritmo específico:

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

Use a sintaxe de ponto para um rótulo e qualquer outro tipo de map:

labels.team=alpha

Uma string entre aspas é interpretada como um valor único, e não como uma sequência de valores.

Campos que aceitam filtros

Você pode filtrar qualquer campo nos objetos que estão sendo retornados.

Método de lista Link para campos que aceitam filtros
keyRings.list Campos KeyRing
cryptoKeys.list Campos CryptoKey
cryptoKeyVersions.list Campos CryptoKeyVersion
importJobs.list Campos ImportJob

Sintaxe de ordem de classificação

Você pode classificar os resultados pelo nome do recurso dos objetos. Estes são os valores de ordem de classificação aceitos no campo orderBy.

Valor Descrição
'' (string vazio) Os resultados são classificados na ordem padrão.
'name' Os resultados são classificados em ordem crescente pelo nome do recurso.
'name desc' Os resultados são classificados em ordem decrescente pelo nome do recurso.