hostgroup.exists

Описание

логическое hostgroup.exists(объект фильтр)

Этот метод проверяет соответствует ли по крайней мере одна группа узлов сети заданному фильтром критерию.

Параметры

(объект) Критерий по которому производить поиск.

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

Параметр Тип Описание
groupid строка/массив ID групп узлов сети.
name строка/массив Имена групп узлов сети.
node строка Имя ноды, которой должны принадлежать группы узлов сети.

Этот параметр переписывает параметр nodeids.
nodeids строка/массив ID нод, которым должны принадлежать группы узлов сети.

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

(логический) Возвращает true, если имеется по крайней мере одна группа узлов сети, которая соответствует заданному фильтром критерию.

Пример

Проверка группы узлов сети на ноде

Проверка имеется ли группа узлов сети с именем "Zabbix servers" на ноде с ID 1.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostgroup.exists",
    "params": {
        "name": "Linux servers",
        "nodeids": [
            "1"
        ]
    },
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": true,
    "id": 1
}

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

Исходный код

CHostGroup::exists() в frontends/php/api/classes/CHostGroup.php.