Ordenar e filtrar resultados de listas

O Cloud Key Management Service suporta a filtragem e a ordenação de resultados das seguintes operações list.

• keyRings.list
• cryptoKeys.list
• cryptoKeyVersions.list
• importJobs.list

O suporte para ordenação e filtragem numa operação list é indicado pela presença dos campos de string filter e orderBy no corpo do pedido de lista. Ambos os campos usam uma linguagem simples para fazer referência aos campos no objeto que está a ser ordenado e/ou filtrado.

Sintaxe do filtro

A sintaxe do filtro consiste numa expressão num ou mais campos dos objetos que estão a ser filtrados.

Pode usar os seguintes operadores de expressão.

Os operadores AND e OR são aceites no mesmo nível de agrupamento. OR tem precedência sobre AND. Pode usar parênteses para substituir a precedência predefinida.

Quando filtrar por valores time, codifique a hora como uma string no formato RFC 3399, como 2019-06-20T01:30:15Z.

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

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

Use a sintaxe de ponto para uma etiqueta e qualquer outro tipo map:

labels.team=alpha

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

Campos filtráveis

Pode filtrar qualquer campo nos objetos devolvidos.

Sintaxe de ordenação

Pode ordenar os resultados pelo campo name do recurso nos objetos. A tabela seguinte mostra os valores de ordem de ordenação suportados para o campo orderBy.