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 |
Opérateur logique ET. L'espace étant interprété comme un opérateur AND, les expressions suivantes sont équivalentes : 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.
| Value | 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. |