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

Удаление всех инцидентов

Запрос

Тип Метод
DELETE /service_asset_findings/all

Описание: при выполнении запроса будут удалены инциденты из базы данных.

Метод поддерживает необязательное тело запроса GenericSearchRequest:

  • если тело запроса передано, будут удалены только инциденты, соответствующие заданным условиям поиска;
  • если тело запроса не передано, будут удалены все инциденты.
Пример запроса

DELETE

http://127.0.0.1/cruddy/v2/service_asset_findings/all

Тело запроса: необязательный объект GenericSearchRequest, содержащий параметры поиска инцидентов.

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

{
  "filters": [
    {
      "field": "status",
      "value": "closed",
      "filter_type": "equal",
      "negation": false
    }
  ],
  "limit": 100,
  "offset": 0
}

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

Если тело запроса отсутствует, удаляются все инциденты.

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

Статус код: 204 – запрос успешно обработан.

Формат: пустое тело ответа.

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

Код Ответ Описание
400 Bad Request Неверный тип параметра запроса, отсутствует обязательный параметр или некорректно указаны параметры авторизации
401 Unauthorized Невозможно аутентифицировать пользователя
422 Ошибка удаления Ошибка удаления инцидентов, связанная с зависимостями или настройкой связей
500 Internal Server Error Другие ошибки сервера

Для ответа 422 возможны следующие значения error_code:

  • 11001 — ошибка связанных данных (зависимостей);
  • 11012 — ошибка некорректно настроенных связей, например отсутствие необходимого каскадного удаления;
  • 11003 — запрос на изменение не затронул ни одной строки.

При наличии связанных данных ответ 422 также может содержать поле relations с информацией о связях, препятствующих удалению.

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

  • 400 — "missing uid header" — отсутствует заголовок Pgr-User-ID;
  • 400 — "Pgr-User-Id should be uuid format" — неверный формат Pgr-User-ID;
  • 400 — "Bad Request" — неверный тип параметра запроса либо отсутствует обязательный параметр;
  • 401 — "can't get user info:" — невозможно аутентифицировать пользователя;
  • 500 — "Internal Server Error" — другие ошибки сервера.

Примечание: Текст ошибки не фиксированный и может изменяться в зависимости от фактического ответа на запрос.

Пример ответа с кодом 400

{
  "error": "Bad Request",
  "error_code": 400
}

Пример ответа с кодом 401

{
  "error": "can't get user info:",
  "error_code": 401
}

Пример ответа с кодом 422

{
  "error_code": 11001,
  "relations": {}
}

Пример ответа с кодом 500

{
  "error": "Internal Server Error",
  "error_code": 500
}