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.