Перейти к содержанию

Массовое обновление результатов сработок правил

Запрос

Тип Метод
POST /logmule_go_results/mass_update

Описание: метод массово обновляет результаты сработок правил корреляции по переданному списку ID.

Метод работает по принципу частичного обновления: изменяются только поля, переданные в запросе.

Всем указанным объектам присваиваются одинаковые значения переданных полей.

Изменение связей не поддерживается.

Метод является транзакционным: если при изменении одного из объектов возникает ошибка, все изменения откатываются.

Пример запроса

POST

http://127.0.0.1/cruddy/v2/logmule_go_results/mass_update

Тело запроса:

Параметр Тип данных Обязательность Описание
ids Array<string> Required Список ID изменяемых результатов
fields object Required Словарь новых значений полей

Элементы массива ids должны иметь формат UUID.

Объект fields соответствует структуре LogmuleGoResultNoRelations. В нём передаются только поля, значения которых необходимо изменить.

Пример тела запроса

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "550e8400-e29b-41d4-a716-446655440001"
  ],
  "fields": {
    "<параметр>": "<значение>"
  }
}

Успешный ответ

Статус код: 200 – объекты успешно изменены.

Тело ответа отсутствует.

Другие возможные ответы

Код Ответ Описание
400 Bad Request Ошибка в параметрах или теле запроса
404 not found Один из изменяемых объектов не найден
409 Конфликт уникальности Попытка присвоить объекту существующее уникальное значение атрибута
500 Internal Server Error Ошибка сервера

Возможные ошибки:

  • 400 — "missing uid header" — отсутствует заголовок Pgr-User-ID;
  • 400 — "Pgr-User-Id should be uuid format" — неверный формат Pgr-User-ID;
  • 400 — "Bad Request" — неверный тип параметра запроса либо отсутствует обязательный параметр;
  • 400 — "ids is empty" — список ID не передан;
  • 400 — "fields is empty" — новые значения полей не переданы;
  • 400 — "exceeded maximum length for a value" — значение превышает максимально допустимую длину;
  • 400 — "id should be uuid format" — недопустимый формат ID;
  • 404 — "not found" — изменяемый объект не существует;
  • 409 — попытка присвоить объекту существующее уникальное значение атрибута;
  • 500 — "Internal Server Error" — другие ошибки при изменении объектов.
Пример ответа с кодом 400

{
  "error": "ids is empty"
}
Пример ответа с кодом 404

{
  "error": "not found"
}
Пример ответа с кодом 500

{
  "error": "Internal Server Error"
}