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
       }
Copy
✔ Copied

Ответ:

{
           "jsonrpc": "2.0",
           "result": true,
           "id": 1
       }
Copy
✔ Copied

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

Исходный код

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.