hostinterface.exists

Описание

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

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

Параметры

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

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

Параметр Тип Описание
dns строка/массив DNS интерфейсов узлов сети.
hostid строка/массив ID узлов сети, которым должны принадлежать интерфейсы узлов сети.
interfaceid строка/массив ID интерфейсов узлов сети.
ip строка/массив IP адреса интерфейсов узлов сети.
node строка Имя ноды, которой должны принадлежать интерфейсы узлов сети.

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

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

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

Примеры

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

Проверка наличия интерфейса узла сети с IP 127.0.0.1 у узла сети 30037.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "hostinterface.exists",
    "params": {
        "hostid": "30037",
        "ip": "127.0.0.1"
    },
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}

Ответ:

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

Исходный код

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