Группы
Серверная документация описывает CRUD-маршруты для групп активов.
Маршруты
| Метод | Путь | Назначение |
|---|---|---|
GET | /groups | Получить список групп. |
POST | /groups | Создать группу. |
GET | /groups/{group_id} | Получить группу по идентификатору. |
PUT | /groups/{group_id} | Обновить группу. |
DELETE | /groups/{group_id} | Удалить группу. |
Фильтры списка
Для GET /groups в серверной документации описаны query-параметры:
nameasset_idlimitpage
Это позволяет получать:
- все группы;
- группы по имени;
- группы, связанные с конкретным asset/host.
Создание группы
Пример тела из серверной документации:
json
{
"name": "office-segment",
"description": "Office hosts",
"asset_ids": [1, 2]
}Обновление группы
Пример тела:
json
{
"name": "office-segment-updated",
"description": "Updated office hosts",
"asset_ids": [1, 2, 3]
}Практическое замечание
В актуальной API-модели группа работает через asset_ids, а не через старую схему с вложенными host-объектами в теле запроса. Это ближе к текущей серверной модели активов.