Cloud Key Management Service es compatible con el filtrado y el ordenamiento de los resultados de las siguientes operaciones de list:
La asistencia para ordenar y filtrar en una operación de list se indica por la presencia de campos de string filter y orderBy en el cuerpo de la solicitud de lista. Ambos campos usan un lenguaje simple para referirse a los campos en el objeto que se ordena o filtra.
Sintaxis de filtro
La sintaxis de filtro consiste en una expresión de uno o más campos del objeto que se filtra.
Puedes usar los siguientes operadores de expresión.
| Operador | Descripción |
|---|---|
= |
Igualdad |
> |
Superior a |
< |
Inferior a |
=> |
Superior o igual a |
<= |
Inferior o igual a |
!=-NOT |
Desigualdad. Los siguientes son equivalentes: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
Contención. Esta es una coincidencia de substring con distinción entre mayúsculas y minúsculas. Como ejemplo, name: "cloud" filtra los recursos que contienen cloud (con distinción entre mayúsculas y minúsculas) en el nombre del recurso. |
AND |
Lógica AND. Un espacio es equivalente a AND, por lo que los siguientes son equivalentes:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
Lógica OR. |
Los operadores AND y OR se aceptan en el mismo nivel de agrupamiento. OR tiene prioridad sobre AND. Puedes usar paréntesis para anular la prioridad predeterminada.
Cuando filtras valores time, codifica la hora como una string en el formato RFC 3399, como 2019-06-20T01:30:15Z.
Cuando accedas a un subcampo, usa la sintaxis de punto. Por ejemplo, el recurso CryptoKey contiene el campo primary. Puedes filtrar los resultados de CryptoKey en el subcampo primary.algorithm para ver un algoritmo específico:
primary.algorithm=RSA_SIGN_PSS_2048_SHA256
Usa la sintaxis de punto para una etiqueta y cualquier otro tipo map:
labels.team=alpha
Una string entre comillas se interpreta como un valor único en lugar de como una secuencia de valores.
Campos filtrables
Puedes filtrar cualquier campo en los objetos que se muestran.
| Método de lista | Vínculo a los campos filtrables |
|---|---|
| keyRings.list | Campos KeyRing |
| cryptoKeys.list | Campos CryptoKey |
| cryptoKeyVersions.list | Campos CryptoKeyVersion |
| importJobs.list | Campos ImportJob |
Sintaxis de orden de clasificación
Puedes ordenar resultados según el campo name del recurso en los objetos. A continuación, se muestran los valores de orden compatibles para el campo orderBy.
| Valor | Descripción |
|---|---|
'' (string vacía) |
Los resultados se ordenan en el orden predeterminado. |
'name' |
Los resultados se ordenan en orden ascendente según el campo name del recurso. |
'name desc' |
Los resultados se ordenan en orden descendente según el campo name del recurso. |