host.getobjects

Описание

массив host.getobjects(объект фильтр)

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

Параметры

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

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

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

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

(массив) Возвращает массив объектов со всеми свойствами.

Примеры

Получение узла сети по имени

Получение узла сети по техническому имени "Zabbix server".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "host.getobjects",
           "params": {
               "name": "Zabbix server"
           },
           "auth": "3a57200802b24cda67c4e4010b50c065",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "maintenances": [],
                   "hostid": "10084",
                   "proxy_hostid": "0",
                   "host": "Zabbix server",
                   "status": "0",
                   "disable_until": "0",
                   "error": "",
                   "available": "1",
                   "errors_from": "0",
                   "lastaccess": "0",
                   "ipmi_authtype": "-1",
                   "ipmi_privilege": "2",
                   "ipmi_username": "",
                   "ipmi_password": "",
                   "ipmi_disable_until": "0",
                   "ipmi_available": "0",
                   "snmp_disable_until": "0",
                   "snmp_available": "0",
                   "maintenanceid": "0",
                   "maintenance_status": "0",
                   "maintenance_type": "0",
                   "maintenance_from": "0",
                   "ipmi_errors_from": "0",
                   "snmp_errors_from": "0",
                   "ipmi_error": "",
                   "snmp_error": "",
                   "jmx_disable_until": "0",
                   "jmx_available": "0",
                   "jmx_errors_from": "0",
                   "jmx_error": "",
                   "name": "Zabbix server"
               }
           ],
           "id": 1
       }

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

host.get

Исходный код

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

Documentation