List-Ergebnisse sortieren und filtern

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.