Cloud Key Management Service admite el filtrado y la ordenación de los resultados de las siguientes operaciones de list.
La compatibilidad con la ordenación y el filtrado en una operación list se indica mediante la presencia de los campos de cadena filter y orderBy en el cuerpo de la solicitud de lista. Ambos campos usan un lenguaje sencillo para hacer referencia a los campos del objeto que se está ordenando o filtrando.
Sintaxis de filtro
La sintaxis del filtro consta de una expresión en uno o varios campos de los objetos que se van a filtrar.
Puede usar los siguientes operadores de expresión.
| Operador | Descripción |
|---|---|
= |
Igualdad. |
> |
Mayor que. |
< |
Menor que. |
=> |
Mayor o igual que. |
<= |
Menor o igual que. |
!=-NOT |
Desigualdad. Las siguientes expresiones son equivalentes: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
Contención. Se trata de una coincidencia de subcadena que no distingue entre mayúsculas y minúsculas. Por ejemplo, name: "cloud" filtra los recursos que contienen cloud (sin distinguir entre mayúsculas y minúsculas) en el nombre del recurso. |
AND |
AND lógico. Un espacio equivale a AND, por lo que las siguientes expresiones son equivalentes:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
OR lógico. |
Los operadores AND y OR se aceptan en el mismo nivel de agrupación. OR tiene prioridad sobre AND. Puedes usar paréntesis para anular la precedencia predeterminada.
Cuando filtre por valores de time, codifique la hora como una cadena en el formato RFC 3399, como 2019-06-20T01:30:15Z.
Para acceder a un subcampo, usa la sintaxis de punto. Por ejemplo, el recurso CryptoKey
contiene el campo primary. Puede filtrar los resultados de CryptoKey en el subcampo primary.algorithm para 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 cadena entre comillas se interpreta como un único valor en lugar de una secuencia de valores.
Campos por los que se puede filtrar
Puedes filtrar por cualquier campo de los objetos devueltos.
| Método de lista | Enlace a los campos que se pueden filtrar |
|---|---|
| keyRings.list | Campos KeyRing |
| cryptoKeys.list | Campos de CryptoKey |
| cryptoKeyVersions.list | Campos de CryptoKeyVersion |
| importJobs.list | Campos de ImportJob |
Sintaxis de ordenación
Puedes ordenar los resultados por el campo name del recurso en los objetos. A continuación, se muestran los valores de orden admitidos para el campo orderBy.
| Valor | Descripción |
|---|---|
'' (cadena vacía) |
Los resultados se ordenan según el orden predeterminado. |
'name' |
Los resultados se ordenan de forma ascendente por el campo name del recurso. |
'name desc' |
Los resultados se ordenan de forma descendente por el campo name del recurso. |