Sidebar
ru:manual:api:reference:hostinterface:exists
Table of Contents
hostinterface.exists
Описание
логическое hostinterface.exists(объект фильтр)
Этот метод проверяет соответствует ли по крайней мере один интерфейс узла сети заданному фильтром критерию.
Этот метод устарел и будет в будущем удален. Вместо него, пожалуйста, воспользуйтесь методом hostinterface.get.
Параметры
(объект) Критерий по которому производить поиск.
Критериями поиска поддерживатся следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| dns | строка/массив | DNS интерфейсов узлов сети. |
| hostid | строка/массив | ID узлов сети, которым должны принадлежать интерфейсы узлов сети. |
| interfaceid | строка/массив | ID интерфейсов узлов сети. |
| ip | строка/массив | IP адреса интерфейсов узлов сети. |
Возвращаемые значения
(логическое) Возвращает 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/include/classes/api/services/CHostInterface.php.