Zabbix Documentation 2.2

Sidebar

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
       }

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

Исходный код

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