Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

hostgroup.get

Описание

integer/array hostgroup.get(параметры объекта)

Этот метод позволяет получать группы узлов сети в соответствии с заданными параметрами.

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект) Параметры задают желаемый вывод.

Этот метод поддерживает следующие параметры.

Параметр Тип Описание
graphids строка/массив Возврат только тех групп узлов сети, которые содержат узлы сети или шаблоны с заданными графиками.
groupids строка/массив Возврат групп узлов сети только с заданными ID групп узлов сети.
hostids строка/массив Возврат только тех групп узлов сети, которые содержат заданные узлы сети.
maintenanceids строка/массив Возврат только тех групп узлов сети, которые задействованы в заданных обслуживаниях.
monitored_hosts флаг Возврат только тех групп узлов сети, которые содержат узлы сети под наблюдением.
real_hosts флаг Возврат только тех групп узлов сети, которые содержат узлы сети.
templated_hosts флаг Возврат только тех групп узлов сети, которые содержат шаблоны.
templateids строка/массив Возврат только тех групп узлов сети, которые содержат заданные шаблоны.
triggerids строка/массив Возврат только тех групп узлов сети, которые узлы сети или шаблоны с заданными триггерами.
with_applications флаг Возврат только тех групп узлов сети, которые содержат узлы сети с группами элементов данных.
with_graphs флаг Возврат только тех групп узлов сети, которые содержат узлы сети с графиками.
with_hosts_and_templates флаг Возврат только тех групп узлов сети, которые содержат узлы сети или шаблоны.
with_httptests флаг Возврат только тех групп узлов сети, которые содержат узлы сети с веб проверками.

Переопределяет параметр with_monitored_httptests.
with_items флаг Возврат только тех групп узлов сети, которые содержат узлы сети или шаблоны с элементами данных.

Переопределяет параметры with_monitored_items и with_simple_graph_items.
with_monitored_httptests флаг Возврат только тех групп узлов сети, которые содержат узлы сети с активированными веб проверками.
with_monitored_items флаг Возврат только тех групп узлов сети, которые узлы сети или шаблоны с активированными элементами данных.

Переопределяет параметр with_simple_graph_items.
with_monitored_triggers флаг Возврат только тех групп узлов сети, которые содержат узлы сети с активированными триггерами. Все элементы данных, используемые в триггере, также должны быть активированы.
with_simple_graph_items флаг Возврат только тех групп узлов сети, которые содержат узлы сети с элементами данных числового типа.
with_triggers флаг Возврат только тех групп узлов сети, которые содержат узлы сети с триггерами.

Переопределяет параметр with_monitored_triggers.
selectDiscoveryRule запрос Возврат LLD правила, которое создало группу узлов сети, в свойстве discoveryRule.
selectGroupDiscovery запрос Возврат объекта обнаружения группы узлов сети в свойстве groupDiscovery.

Объект обнаружения групп узлов сети связывает обнаруженную группу узов сети с прототипом групп узлов сети и имеет следующие свойства:
groupid - (строка) ID обнаруженной группы узлов сети;
lastcheck - (штамп времени) время, когда группа узлов сети была в последний раз обнаружена;
name - (строка) имя прототипа групп узлов сети;
parent_group_prototypeid - (строка) ID прототипа групп узлов сети с которого была создана группа узлов сети;
ts_delete - (штамп времени) время, когда более необнаруживаемая группа узлов сети будет удалена..
selectHosts запрос Возврат узлов сети, которые принадлежат группе узлов сети, в свойстве hosts.

Поддерживается count.
selectTemplates запрос Возврат шаблонов, которые принадлежат группе узлов сети, в свойстве templates.

Поддерживается count.
limitSelects целое число Ограничение количества записей, возвращаемых подзапросами.

Применимо только к следующим подзапросам:
selectHosts - все результаты сортируются по host;
selectTemplates - все результаты сортируются по host.
sortfield строка/массив Сортировка результата в соответствии с заданными свойствами.

Возможные значения: groupid, name.
countOutput логический Эти параметры являются общими для всех методов get и они описаны в справочных комментариях.
editable логический
excludeSearch логический
filter объект
limit целое число
output запрос
preservekeys логический
search объект
searchByAny логический
searchWildcardsEnabled логический
sortorder строка/массив
startSearch логический

Возвращаемые значения

(целое число/массив) Возвращает либо:

  • · массив объектов;
  • · количество извлеченных объектов, если использовался параметр countOutput.

Примеры

Получение данных по имени

Получить все данные двух групп узлов с именами "Zabbix servers" и "Linux servers".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "hostgroup.get",
           "params": {
               "output": "extend",
               "filter": {
                   "name": [
                       "Zabbix servers",
                       "Linux servers"
                   ]
               }
           },
           "auth": "6f38cddc44cfbb6c1bd186f9a220b5a0",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "groupid": "2",
                   "name": "Linux servers",
                   "internal": "0"
               },
               {
                   "groupid": "4",
                   "name": "Zabbix servers",
                   "internal": "0"
               }
           ],
           "id": 1
       }

Смотрите также

Источник

CHostGroup::get() в ui/include/classes/api/services/CHostGroup.php.