Cloud Key Management Service unterstützt das Filtern und Sortieren von Ergebnissen aus den folgenden list-Vorgängen:
In einem list-Vorgang wird das Sortieren und Filtern unterstützt, wenn im Listenanfragetext die Stringfelder filter und orderBy vorhanden sind. Beide Felder verwenden eine einfache Sprache, um auf die Felder in dem Objekt zu verweisen, das sortiert und/oder gefiltert wird.
Filtersyntax
Die Filtersyntax besteht aus einem Ausdruck für ein oder mehrere Felder der zu filternden Objekte.
Sie können die folgenden Operatoren verwenden.
| Operator | Beschreibung |
|---|---|
= |
Gleich. |
> |
Größer als. |
< |
Kleiner als. |
=> |
Größer als oder gleich. |
<= |
Kleiner als oder gleich. |
!=-NOT |
Ungleich. Folgendes ist äquivalent: name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
Eingrenzung. Dies ist ein Teilstring-Abgleich, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird. Beispielsweise filtert name: "cloud" nach Ressourcen, deren Ressourcenname cloud enthält (ohne Berücksichtigung der Groß-/Kleinschreibung). |
AND |
Logisches UND. Ein Leerzeichen ist gleichbedeutend mit AND. Daher ist Folgendes äquivalent:name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
Logisches ODER. |
Die Operatoren AND und OR werden auf derselben Gruppierungsebene akzeptiert. OR hat Vorrang vor AND. Sie können Klammern verwenden, um die Standardpriorität zu überschreiben.
Wenn nach time-Werten gefiltert wird, codieren Sie die Zeit als einen String im RFC 3399-Format. Beispiel: 2019-06-20T01:30:15Z
Verwenden Sie für den Zugriff auf ein untergeordnetes Feld die Punktsyntax. Ein Beispiel: Die Ressource CryptoKey enthält das Feld primary. Sie können CryptoKey-Ergebnisse im untergeordneten Feld primary.algorithm für einen bestimmten Algorithmus filtern:
primary.algorithm=RSA_SIGN_PSS_2048_SHA256
Verwenden Sie die Punktsyntax für Labels und beliebige andere map-Typen:
labels.team=alpha
Ein String in Anführungszeichen wird als einzelner Wert und nicht als Folge von Werten interpretiert.
Filterbare Felder
Sie können nach jedem Feld in den zurückgegebenen Objekten filtern.
| List-Methode | Link zu filterbaren Feldern |
|---|---|
| keyRings.list | KeyRing-Felder |
| cryptoKeys.list | CryptoKey-Felder |
| cryptoKeyVersions.list | CryptoKeyVersion-Felder |
| importJobs.list | ImportJob-Felder |
Syntax der Sortierreihenfolge
Sie können die Ergebnisse nach dem Feld name der Ressource sortieren. Dies sind die unterstützten Werte für die Sortierreihenfolge des Feldes orderBy:
| Wert | Beschreibung |
|---|---|
'' (leerer String) |
Die Ergebnisse werden in der Standardreihenfolge sortiert. |
'name' |
Die Ergebnisse werden in aufsteigender Reihenfolge nach dem Feld name der Ressource sortiert. |
'name desc' |
Die Ergebnisse werden in absteigender Reihenfolge nach dem Feld name der Ressource sortiert. |