Массовое обновление результатов сработок правил
Запрос
| Тип | Метод |
|---|---|
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"
}