Массовое удаление рабочих столов
Запрос
| Тип | Метод |
|---|---|
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"— ошибка сервера.