Sintaxe de classificação

Para ordenar os resultados que são retornados em uma solicitação de recuperação de API, HTTP GET, alguns IBM® QRadar® Os pontos de extremidade da API que retornam listas de recursos são compatíveis com o parâmetro sort .

A sintaxe de parâmetro sort é consistente para todos os terminais que o suportam. Consulte a documentação para o endpoint para determinar se o parâmetro de classificação se aplica a ele. Quaisquer limitações sobre a sintaxe de classificação são incluídas na descrição desse endpoint. Para assegurar que espaços ou caracteres especiais sejam codificados corretamente, lembre-se de que os parâmetros de consulta devem ser codificados por URL dupla antes de serem enviados.

Operadores de classificação

Operador Descrição Exemplo
+ O campo de classificação está em ordem crescente. Classifique o campo add_time em ordem crescente:

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

- O campo de classificação está em ordem decrescente. Classifique o campo version em ordem decrescente:

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

Classificando múltiplos campos

É possível classificar múltiplos campos separando-os com uma vírgula. No exemplo a seguir, o campo version é classificado em ordem decrescente. Em seguida, dentro de cada grupo version, o campo add_time é classificado em ordem crescente.

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

Escapando caracteres em sequências de classificação

Escape qualquer caractere na sequência de classificação precedendo-a com uma barra invertida (\). Se algum dos caracteres a seguir estiver dentro de um identificador de campo, deve-se escapá-los:

  • ,
  • (
  • )
  • \