O Cloud Key Management Service suporta a filtragem e a ordenação de resultados das seguintes operações 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.
| Operador | Descrição |
|---|---|
= |
Igualdade. |
> |
Maior que. |
< |
Inferior a. |
=> |
Maior ou igual a. |
<= |
Menor ou igual a. |
!=-NOT |
Desigualdade. O seguinte é equivalente: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
Contenção. Esta é uma correspondência de substring não sensível a maiúsculas e minúsculas. Por exemplo, name: "cloud" filtra recursos que contêm cloud (não sensível a maiúsculas e minúsculas) no nome do recurso. |
AND |
E lógico. Um espaço é equivalente a AND, pelo que o seguinte é equivalente:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
OU lógico. |
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.
| Método de listagem | Link para campos filtráveis |
|---|---|
| keyRings.list | Campos KeyRing |
| cryptoKeys.list | Campos CryptoKey |
| cryptoKeyVersions.list | Campos CryptoKeyVersion |
| importJobs.list | Campos ImportJob |
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.
| Valor | Descrição |
|---|---|
'' (string vazia) |
Os resultados são ordenados pela ordem predefinida. |
'name' |
Os resultados são ordenados por ordem ascendente pelo campo name do recurso. |
'name desc' |
Os resultados são ordenados por ordem descendente pelo campo name do recurso. |