Documentation
Table of Contents
host.get
Description
целое число/массив host.get(объект параметры)
Этот метод позволяет получать узлы сети в соответствии с заданными параметрами.
Параметры
(объект) Параметры задают желаемый вывод.
Этот метод поддерживает следующие параметры.
| Параметр | Тип | Описание |
|---|---|---|
| groupids | строка/массив | Возврат только тех узлов сети, которые принадлежат заданным группам узлов сети. |
| applicationids | строка/массив | Возврат только тех узлов сети, которые имеют заданные группы элементов данных. |
| dserviceids | строка/массив | Возврат только тех узлов сети, которые относятся к заданным обнаруженным сервисам. |
| graphids | строка/массив | Возврат только тех узлов сети, которые имеют заданные графики. |
| hostids | строка/массив | Возврат узлов сети только с заданными ID узлов сети. |
| httptestids | строка/массив | Возврат только тех узлов сети, которые имеют заданные веб проверки. |
| interfaceids | строка/массив | Возврат только тех узлов сети, которые используют заданные интерфейсы. |
| itemids | строка/массив | Возврат только тех узлов сети, которые имеют заданные элементы данных. |
| maintenanceids | строка/массив | Возврат только тех узлов сети, на которых действуют заданные обслуживания. |
| monitored_hosts | флаг | Возврат узлов сети только под наблюдением. |
| proxy_hosts | флаг | Возврат только прокси. |
| proxyids | строка/массив | Возврат только тех узлов сети, которые наблюдаются заданными прокси. |
| templated_hosts | флаг | Возврат как узлов сети, так и шаблонов. |
| templateids | строка/массив | Возврат только тех узлов сети, к которым присоединены заданные шаблоны. |
| triggerids | строка/массив | Возврат только тех узлов сети, которые имеют заданные триггеры. |
| with_items | флаг | Возврат только тех узлов сети, у которых имеются элементы данных. Переопределяет параметры with_monitored_items и with_simple_graph_items. |
| with_applications | флаг | Возврат только тех узлов сети, которые имеют группы элементов данных. |
| with_graphs | флаг | Возврат только тех узлов сети, которые имеют графики. |
| with_httptests | флаг | Возврат только тех узлов сети, которые имеют веб проверки. Переопределяет параметр with_monitored_httptests. |
| with_monitored_httptests | флаг | Возврат только тех узлов сети, которые имеют активированные веб проверки. |
| with_monitored_items | флаг | Возврат только тех узлов сети, которые имеют активированные элементы данных. Переопределяет параметр with_simple_graph_items. |
| with_monitored_triggers | флаг | Возврат только тех узлов сети, которые имеют активированные триггеры. Все элементы данных, используемые в триггере, также должны быть активированы. |
| with_simple_graph_items | флаг | Возврат только тех узлов сети, которые имеют элементы данных с числовым типом информации. |
| with_triggers | флаг | Возврат только тех узлов сети, которые имеют триггеры. Переопределяет параметр with_monitored_triggers. |
| withInventory | флаг | Возврат только тех узлов сети, которые имеют данные инвентаризации. |
| selectGroups | запрос | Возврат групп узлов сети, которым принадлежит узел сети, в свойстве groups. |
| selectApplications | запрос | Возврат групп элементов данных с узла сети в свойстве applications.Поддерживается count. |
| selectDiscoveries | запрос | Возврат низкоуровневых обнаружений с узла сети в свойстве discoveries.Поддерживается count. |
| selectDiscoveryRule | запрос | Возврат LLD правил, которые создали узел сети, в свойстве discoveryRule. |
| selectGraphs | запрос | Возврат графиков с узла сети в свойстве graphs.Поддерживается count. |
| selectHostDiscovery | запрос | Возврат объекта обнаружения узла сети в свойстве hostDiscovery.Объект обнаружения узлов сети связывает обнаруженный узел сети с прототипом узлов сети или прототипы узлов сети с LLD правилом и имеет следующие свойства: host - (строка) имя узла сети прототипа узлов сети;hostid - (строка) ID обнаруженного узла сети или прототипа узлов сети;parent_hostid - (строка) ID прототипа узлов сети с которого был создан узел сети;parent_itemid - (строка) ID правила LLD, которое создало обнаруженный узел сети;lastcheck - (штамп времени) время, когда узел сети был в последний раз обнаружен;ts_delete - (штамп времени) время, когда более необнаруживаемый узел сети будет удален. |
| selectHttpTests | запрос | Возврат веб-сценариев с узла сети в свойстве httpTests.Поддерживается count. |
| selectInterfaces | запрос | Возврат интерфейсов узла сети в свойстве interfaces.Поддерживается count. |
| selectInventory | запрос | Возврат данных инвентаризации узла сети с узла сети в свойстве inventory. |
| selectItems | запрос | Возврат элементов данных с узла сети в свойстве items.Поддерживается count. |
| selectMacros | запрос | Возврат макросов с узла сети в свойстве macros. |
| selectParentTemplates | запрос | Возврат шаблонов, к которым присоединен узел сети, в свойстве parentTemplates.Поддерживается count. |
| selectScreens | запрос | Возврат комплексных экранов с узла сети в свойстве screens.Поддерживается count. |
| selectTriggers | запрос | Возврат триггеров с узла сети в свойстве triggers.Поддерживается count. |
| filter | объект | Возврат только тех результатов, которые в точности соответствуют заданному фильтру. Принимает массив, где ключи являются именами свойств и значения, которые являются либо одним значением, либо массивом сопоставляемых значений. Позволяет фильтровать по свойствам интерфейсов. |
| limitSelects | целое число | Ограничение количества записей, возвращаемых подзапросами. Применимо только к следующим подзапросам: selectParentTemplates - все результаты сортируются по host;selectInterfaces;selectItems - сортируются по name;selectDiscoveries - сортируются по name;selectTriggers - сортируются по description;selectGraphs - сортируются по name;selectApplications - сортируются по name;selectScreens - сортируются по name. |
| search | объект | Возврат результатов, которые соответствуют заданному шаблону поиска. Принимает массив, где ключи являются именами свойств и значения являются строками по которым производить поиск. Если дополнительные опции не заданы, эта опция выполнит поиск LIKE "%…%".Позволяет выполнять поиск по свойствам интерфейсов. Работает только с текстовыми полями. |
| searchInventory | объект | Возврат только тех узлов сети, инвентарные данные которых соответствуют заданному шаблону поиска. Этот параметр зависит от тех же дополнительных параметров что и search. |
| sortfield | строка/массив | Сортировка результата в соответствии с заданными свойствами. Возможные значения: hostid, host, name, status. |
| countOutput | флаг | Эти параметры являются общими для всех методов get и они описаны в справочных комментариях. |
| editable | логический | |
| excludeSearch | флаг | |
| limit | целое число | |
| output | запрос | |
| preservekeys | флаг | |
| searchByAny | логический | |
| searchWildcardsEnabled | логический | |
| sortorder | строка/массив | |
| startSearch | флаг |
Возвращаемые значения
(целое число/массив) Возвращает либо:
- массив объектов;
- количество найденных объектов, если используется параметр
countOutput.
Примеры
Получение данных по имени
Получение всех данных о двух узлах сети с именами "Zabbix server" и "Linux server".
Запрос:
{ "jsonrpc": "2.0", "method": "host.get", "params": { "output": "extend", "filter": { "host": [ "Zabbix server", "Linux server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }Ответ:
{ "jsonrpc": "2.0", "result": [ { "maintenances": [], "hostid": "10160", "proxy_hostid": "0", "host": "Zabbix server", "status": "0", "disable_until": "0", "error": "", "available": "0", "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" }, { "maintenances": [], "hostid": "10167", "proxy_hostid": "0", "host": "Linux server", "status": "0", "disable_until": "0", "error": "", "available": "0", "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": "Linux server" } ], "id": 1 }Получение групп узлов сети
Получение имен групп узлов сети членами которых является узел сети "Zabbix server", без деталей о самом узле сети.
Запрос:
{ "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectGroups": "extend", "filter": { "host": [ "Zabbix server" ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 }Ответ:
{ "jsonrpc": "2.0", "result": [ { "hostid": "10085", "groups": [ { "groupid": "2", "name": "Linux servers", "internal": "0", "flags": "0" }, { "groupid": "4", "name": "Zabbix servers", "internal": "0", "flags": "0" } ] } ], "id": 2 }Получение присоединенных шаблонов
Получение ID и имен шаблонов, которые присоединены к узлу сети "10084".
Запрос:
{ "jsonrpc": "2.0", "method": "host.get", "params": { "output": ["hostid"], "selectParentTemplates": [ "templateid", "name" ], "hostids": "10084" }, "id": 1, "auth": "70785d2b494a7302309b48afcdb3a401" }Ответ:
{ "jsonrpc": "2.0", "result": [ { "hostid": "10084", "parentTemplates": [ { "name": "Template OS Linux", "templateid": "10001" }, { "name": "Template App Zabbix Server", "templateid": "10047" } ] } ], "id": 1 }Поиск по данным инвентаризации узла сети
Получение всех узлов сети, которые содержат слово "Linux" в поле "ОС" инвентаризации узла сети.
Запрос:
{ "jsonrpc": "2.0", "method": "host.get", "params": { "output": [ "host" ], "selectInventory": [ "os" ], "searchInventory": { "os": "Linux" } }, "id": 2, "auth": "7f9e00124c75e8f25facd5c093f3e9a0" }Ответ:
{ "jsonrpc": "2.0", "result": [ { "hostid": "10084", "host": "Zabbix server", "inventory": { "os": "Linux Ubuntu" } }, { "hostid": "10107", "host": "Linux server", "inventory": { "os": "Linux Mint" } } ], "id": 1 }Смотрите также
Исходный код
CHost::get() в frontends/php/include/classes/api/services/CHost.php.