Trier et filtrer les résultats d'une liste

Cloud Key Management Service permet de filtrer et de trier les résultats des opérations list suivantes.

La possibilité de trier et de filtrer les résultats d'une opération list est indiquée par la présence des champs de chaîne filter et orderBy dans le corps de la requête de liste. Ces deux champs font appel à une syntaxe simple pour faire référence aux champs de l'objet trié et/ou filtré.

Syntaxe des filtres

La syntaxe de filtrage consiste en une expression portant sur un ou plusieurs champs des objets filtrés.

Cette expression accepte les opérateurs suivants.

Opérateur Description
= Égal à
> Supérieur à
< Inférieur à
=> Supérieur ou égal à
<= Inférieur ou égal à
!=
-
NOT
Inégalité.
Les éléments suivants sont équivalents :
name != "quickstart"
-name="quickstart"
NOT name = "quickstart"
: Inclusion. Il s'agit d'une correspondance de sous-chaîne sensible à la casse.
Par exemple, name: "cloud" filtre les ressources contenant cloud (non sensibles à la casse) dans le nom de la ressource.
AND Logical AND (Opérateur logique ET) Un espace équivaut à AND. Les éléments suivants sont donc équivalents:
name: "cloud" AND name: "kms"
name: "cloud" name: "kms"
OR Opérateur logique OU

Les opérateurs AND et OR sont acceptés au sein d'un même niveau de regroupement. OR est prioritaire sur AND. Vous pouvez utiliser des parenthèses pour ignorer la priorité par défaut.

Lors du filtrage sur les valeurs time, encodez l'heure sous la forme de chaîne au format RFC 3399, par exemple 2019-06-20T01:30:15Z.

Pour accéder à un sous-champ, utilisez la syntaxe à points. Par exemple, la ressource CryptoKey contient le champ primary. Vous pouvez filtrer les résultats de CryptoKey sur le sous-champ primary.algorithm en fonction d'un algorithme donné :

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

La syntaxe à points vous permet de filtrer sur une étiquette ou sur tout autre type de correspondance (map ) :

labels.team=alpha

Une chaîne entre guillemets est interprétée comme une valeur unique plutôt que comme une séquence de valeurs.

Champs acceptant le filtrage

Vous pouvez filtrer sur n'importe quel champ des objets renvoyés.

Méthode list Lien vers les champs filtrables
keyRings.list Champs KeyRing
cryptoKeys.list Champs CryptoKey
cryptoKeyVersions.list Champs CryptoKeyVersion
importJobs.list Champs ImportJob

Syntaxe de l'ordre de tri

Vous pouvez trier les résultats en fonction du champ name de la ressource sur les objets. Les valeurs d'ordre de tri acceptées pour le champ orderBy sont les suivantes.

Valeur Description
'' (chaîne vide) Les résultats sont triés dans l'ordre par défaut.
'name' Les résultats sont triés par ordre croissant en fonction du champ name de la ressource.
'name desc' Les résultats sont triés par ordre décroissant en fonction du champ name de la ressource.