ソート構文

API検索リクエスト、 HTTP GETで返される結果を順番に並べるために、リソースのリストを返すいくつかのAPIエンドポイントは パラメータをサポートしている。 IBM® QRadar® リソースのリストを返すAPIエンドポイントは、 sort パラメータをサポートしています。

sort パラメーターの構文は、そのパラメーターをサポートしているすべてのエンドポイントで一貫性があります。 エンドポイントの資料を参照し、ソート・パラメーターがそれに適用されるかどうかを判別してください。 ソート構文の制限事項はすべて、そのエンドポイントの説明に記載されています。 スペースや特殊文字が適切にエンコードされるようにするために、照会パラメーターは、それらを送信する前に二重 URL エンコードする必要があることに注意してください。

ソート演算子

演算子 説明
+ ソート・フィールドは昇順になります。 昇順で add_time フィールドをソートする場合は、以下のようにします。

/api/config/extension_management/extensions?sort=%2Badd_time

- ソート・フィールドは降順になります。 降順で version フィールドをソートする場合は、以下のようにします。

/api/config/extension_management/extensions?sort=-version

複数のフィールドのソート

複数のフィールドは、それらのフィールドをコンマで区切ることによりソートできます。 以下の例では、version フィールドが降順でソートされます。 その後、各 version グループ内で、add_time フィールドが昇順でソートされます。

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

ソート・ストリングの文字のエスケープ

ソート・ストリング内の任意の文字の前に円記号(\)を付けてエスケープします。以下の文字のいずれかがフィールドID内にある場合は、それらをエスケープする必要があります。

  • ,
  • (
  • )
  • \