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 campo name do recurso nos objetos. Estes são os valores de ordem de classificação aceitos no 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 campo name do recurso. |
'name desc' |
Os resultados são classificados em ordem decrescente pelo campo name do recurso. |