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": {
               "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",
                   "description": "The Zabbix monitoring server.",
                   "tls_connect": "1",
                   "tls_accept": "1",
                   "tls_issuer": "",
                   "tls_subject": "",
                   "tls_psk_identity": "",
                   "tls_psk": ""
               },
               {
                   "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",
                   "description": "",
                   "tls_connect": "1",
                   "tls_accept": "1",
                   "tls_issuer": "",
                   "tls_subject": "",
                   "tls_psk_identity": "",
                   "tls_psk": ""
               }
           ],
           "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.

Searching hosts by problem severity

Retrieve hosts that have "Disaster" problems.

Request:

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "output": ["name"],
               "severities": 5
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "hostid": "10160",
                   "name": "Zabbix server"
               }
           ],
           "id": 1
       }

Retrieve hosts that have "Average" and "High" problems.

Request:

{
           "jsonrpc": "2.0",
           "method": "host.get",
           "params": {
               "output": ["name"],
               "severities": [3, 4]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "hostid": "20170",
                   "name": "Database"
               },
               {
                   "hostid": "20183",
                   "name": "workstation"
               }
           ],
           "id": 1
       }

See also

Source

CHost::get() in ui/include/classes/api/services/CHost.php.