Skip to content

Группы

Серверная документация описывает CRUD-маршруты для групп активов.

Маршруты

МетодПутьНазначение
GET/groupsПолучить список групп.
POST/groupsСоздать группу.
GET/groups/{group_id}Получить группу по идентификатору.
PUT/groups/{group_id}Обновить группу.
DELETE/groups/{group_id}Удалить группу.

Фильтры списка

Для GET /groups в серверной документации описаны query-параметры:

  • name
  • asset_id
  • limit
  • page

Это позволяет получать:

  • все группы;
  • группы по имени;
  • группы, связанные с конкретным 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-объектами в теле запроса. Это ближе к текущей серверной модели активов.

Документация NRunner