host.exists

Описание

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

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

Параметры

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

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

Параметр	Тип	Описание
hostid	строка/массив	ID узлов сети.
host	строка/массив	Технические имена узлов сети.
name	строка/массив	Видимые имена узлов сети.
node	строка	Имя ноды, которой должны принадлежать узлы сети. Этот параметр переписывает параметр `nodeids`.
nodeids	строка/массив	ID нод, которым должны принадлежать узлы сети.

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

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

Пример

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

Проверка имеется ли узел сети с техническим именем "Zabbix Server" на ноде с ID 1.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.exists",
           "params": {
               "host": "Zabbix Server",
               "nodeids": [
                   "1"
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

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

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

Исходный код

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

Documentation