Sortiersyntax

Um die Ergebnisse zu ordnen, die in einer API-Abrufanforderung zurückgegeben werden, HTTP GET, unterstützen einige IBM® QRadar® API-Endpunkte, die Listen von Ressourcen zurückgeben, unterstützen den Parameter sort .

Die Syntax des Parameters sort ist für alle Endpunkte konsistent, die sie unterstützen. Stellen Sie anhand der Dokumentation für den Endpunkt fest, ob der Sortierparameter für den Endpunkt gilt. Alle Einschränkungen für die Sortiersyntax sind in der Beschreibung dieses Endpunkts enthalten. Um sicherzustellen, dass Leer- oder Sonderzeichen richtig kodiert werden, sollten Sie daran denken, dass Abfrageparameter doppelt URL kodiert sein müssen, bevor sie gesendet werden.

Sortieroperatoren

Bediener	Beschreibung	Beispiel
`+`	Das Sortierfeld ist aufsteigend sortiert.	Sortieren Sie das Feld `add_time` in aufsteigender Reihenfolge: `/api/config/extension_management/extensions?sort=%2Badd_time`
`-`	Das Sortierfeld wird in absteigender Reihenfolge sortiert.	Feld `version` in absteigender Reihenfolge sortieren: `/api/config/extension_management/extensions?sort=-version`

Mehrere Felder sortieren

Sie können mehrere Felder sortieren, indem Sie sie durch Kommas trennen. Im folgenden Beispiel wird das Feld version in absteigender Reihenfolge sortiert. Anschließend wird das Feld add_time innerhalb jeder version -Gruppe in aufsteigender Reihenfolge sortiert.

/api/config/extension_management/extensions?sort=-version%2C%2Badd_time

Escapezeichen in Sortierzeichenfolgen

Versehen Sie jedes Zeichen in der Sortierzeichenfolge mit Escapezeichen, indem Sie ihm einen Backslash (\) voranstellen. Wenn eines der folgenden Zeichen in einer Feld-ID enthalten ist, müssen Sie sie mit Escapezeichen versehen:

,
(
)
\