Массовое обновление активов
Запрос
| Тип | Метод |
|---|---|
POST |
/service_assets/mass_update |
Описание: При выполнении запроса выбранным параметрам активов будут присвоены новые значения.
Работает по принципу частичного обновления, т.е. будут обновлены только те поля модели которые были переданы в запросе.
Всем объектам будут присвоены одинаковые значения в переданных полях.
Изменение связей не поддерживается.
Метод транзакционный, если произошла ошибка изменения одного из объектов, откатываются все изменения.
Пример запроса
POST
http://127.0.0.1/cruddy/v2/service_assets/mass_update
Тело запроса:
| Параметр | Тип данных | Обязательность | Описание |
|---|---|---|---|
| ids | Array<string> |
Required | Список ID объектов |
| fields | DefaultObject |
Required | Словарь новых значений полей модели ServiceAsset |
| fields{param_1} | Зависит от изменяемого параметра в соответствии с моделью | Optional | Первый параметр, который необходимо изменить в соответствии с моделью объекта, например type |
| fields{param_n} | Зависит от изменяемого параметра в соответствии с моделью | Optional | N-ый параметр, который необходимо изменить в соответствии с моделью объекта, например location |
Пример тела запроса
{
"ids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"fields": {
"type": "Host",
"name": "Актив",
"description": "Описание актива",
"coordinates": "--- []",
"active": true,
"scan_id": "9a59f0f5-5572-476d-a7fc-c960ef43a5af",
"value": 3,
"client_note": "string",
"internal_note": "string",
"location": "string",
"network_exposure": 3,
"responsible_person": "string",
"technical_specialist": "string",
"responsible_group_id": "2d40d7ca-3218-4132-89ef-42e29379a567",
"edited_by": "9501acb5-3be0-4719-a60e-dfa79624666c"
}
}
Успешный ответ
Статус код: 200 – объекты успешно изменены.
Другие возможные ответы
| Код | Ответ | Описание |
|---|---|---|
400 |
1. Bad Request2. ids is empty3. fields is empty4. exceeded maximum length for a value5. id should be uuid format |
1. Неверный тип параметра запроса, либо отсутствует обязательный параметр 2. Список ID не передан 3. Новые значения полей не переданы 4. Значение превышает максимально допустимую длину 5. Недопустимый формат ID |
404 |
not found |
Объект не найден |
409 |
name_already_used |
Попытка создать объект с существующим уникальным атрибутом |
500 |
Internal Server Error |
Другие ошибки сервера |
Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.
Пример ответа
Код 400
{
"error": "Bad Request",
"error_code": 400
}
Код 404
{
"error": "Not Found",
"error_code": 404
}
Код 409
{
"error": "name_already_used",
"error_code": 409,
"extra": {
"fields": [
"name"
]
}
}
Код 500
{
"error": "Internal Server Error",
"error_code": 500
}