Como classificar e filtrar resultados da lista

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

O suporte para classificação e filtragem em uma operação list é indicado pela presença dos 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.
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 e minúsculas.
Como exemplo, name: "cloud" filtra recursos que contêm cloud (indiferentes a maiúsculas) no nome do recurso.
AND "AND" 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 "OR" lógico.

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

Ao filtrar valores time, codifique a hora 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 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 para qualquer outro tipo 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. A tabela a seguir mostra os valores de ordem de classificação compatíveis para o campo orderBy.

Valor Descrição
'' (string vazia) 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.