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

Массовое удаление рабочих столов

Запрос

Тип Метод
POST /dashboards/mass_delete

Описание: метод удаляет рабочие столы по списку идентификаторов.

Удаление рабочего стола доступно только его владельцу или администратору.

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

POST

http://127.0.0.1/cruddy/v2/dashboards/mass_delete

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

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

{
  "ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "660e8400-e29b-41d4-a716-446655440001"
  ]
}

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

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

Формат: JSON.

Для каждого переданного ID возвращается отдельный результат удаления.

Параметр Тип данных Описание
results Array<object> Список результатов удаления рабочих столов
results[].id string ID рабочего стола
results[].error_code integer Код результата удаления
results[].relations object Информация о связанных объектах, препятствующих удалению

Возможные значения error_code:

Код Описание
0 Рабочий стол удалён без ошибок
1497 Ошибка при чтении рабочего стола из БД
11011 Ошибка связанных данных
11002 Общая ошибка удаления
11004 Рабочий стол не найден
11005 Нет доступа на удаление рабочего стола
12012 Недопустимое значение ID
Пример ответа

{
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "error_code": 0
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "error_code": 11005
    }
  ]
}

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

Код Ответ Описание
400 Bad Request Ошибка в параметрах или теле запроса
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;
  • 500 — "Internal Server Error" — ошибка сервера.