Zabbix Documentation 5.2

3.04.04.45.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


ru:manual:api:reference:hostinterface:get

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

ru:manual:api:reference:hostinterface:get [2019/01/28 14:49]
ru:manual:api:reference:hostinterface:get [2019/10/07 06:35] (current)
Line 1: Line 1:
 +===== hostinterface.get =====
  
 +==== Описание ====
 +
 +''​целое число/​массив hostinterface.get(объект **параметры**)''​
 +
 +Этот метод позволяет получать интерфейсы узлов сети в соответствии с заданными параметрами.
 +
 +==== Параметры ====
 +
 +''​(объект)''​ Параметры задают желаемый вывод.
 +
 +Этот метод поддерживает следующие параметры.
 +
 +^ Параметр ^ Тип ^ Описание ^
 +| hostids | строка/​массив | Возврат только тех интерфейсов узлов сети, которые используются заданными узлами сети. |
 +| interfaceids | строка/​массив | Возврат интерфейсов узлов сети только с заданными IDs. |
 +| itemids | строка/​массив | Возврат только тех интерфейсов узлов сети, которые используются заданными элементами данных. |
 +| triggerids | строка/​массив | Возврат только тех узлов сети, которые используются элементами данных в заданных триггерах. |
 +^ |||
 +| selectItems | запрос | Возврат элементов данных,​ которые используют интерфейс,​ в свойстве ''​items''​. \\ \\ Поддерживается ''​count''​. | 
 +| selectHosts | запрос | Возврат узла сети, который использует интерфейс,​ в виде массива в свойстве ''​hosts''​. | 
 +^ |||
 +| limitSelects | целое число | Ограничение количества записей,​ возвращаемых подзапросами. ​ \\  \\ Применимо только к следующим подзапросам:​ \\ ''​selectItems''​. |
 +| sortfield | строка/​массив | Сортировка результата в соответствии с заданными свойствами. \\ \\ Возможные значения:​ ''​interfaceid'',​ ''​dns'',​ ''​ip''​. ​ |
 +|countOutput|логический|Эти параметры являются общими для всех методов ''​get''​ и они описаны в [[ru:​manual:​api:​reference_commentary#​общие_параметры_get_метода|справочных комментариях]]. ​ |
 +| editable |логический|:::​|
 +| excludeSearch |логический|:::​|
 +| filter | объект |:::|
 +| limit |целое число|:::​|
 +| output |запрос|:::​|
 +| preservekeys |логический|:::​|
 +| search | объект |:::|
 +| searchByAny | логический |:::|
 +| searchWildcardsEnabled |логический|:::​|
 +| sortorder | строка/​массив | ::: |
 +| startSearch |логический|:::​|
 +==== Возвращаемые значения ====
 +
 +''​(целое число/​массив)''​ Возвращает либо:
 +  * массив объектов;​
 +  * количество найденных объектов,​ если используется параметр ''​countOutput''​.
 +
 +==== Примеры ====
 +
 +=== Получение интерфейсов узлов сети ===
 +
 +Получение всех данных о интерфейсах,​ которые используются узлом сети "​30057"​.
 +
 +Запрос:​
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​method":​ "​hostinterface.get",​
 +    "​params":​ {
 +        "​output":​ "​extend",​
 +        "​hostids":​ "​30057"​
 +    },
 +    "​auth":​ "​038e1d7b1735c6a5436ee9eae095879e",​
 +    "​id":​ 1
 +}
 +</​code>​
 +
 +Ответ:
 +<code java>
 +{
 +    "​jsonrpc":​ "​2.0",​
 +    "​result":​ [
 +        {
 +            "​interfaceid":​ "​30050",​
 +            "​hostid":​ "​30057",​
 +            "​main":​ "​1",​
 +            "​type":​ "​1",​
 +            "​useip":​ "​1",​
 +            "​ip":​ "​127.0.0.1",​
 +            "​dns":​ "",​
 +            "​port":​ "​10050",​
 +            "​bulk":​ "​1"​
 +        },
 +        {
 +            "​interfaceid":​ "​30067",​
 +            "​hostid":​ "​30057",​
 +            "​main":​ "​0",​
 +            "​type":​ "​1",​
 +            "​useip":​ "​0",​
 +            "​ip":​ "",​
 +            "​dns":​ "​localhost",​
 +            "​port":​ "​10050",​
 +            "​bulk":​ "​1"​
 +        },
 +        {
 +            "​interfaceid":​ "​30068",​
 +            "​hostid":​ "​30057",​
 +            "​main":​ "​1",​
 +            "​type":​ "​2",​
 +            "​useip":​ "​1",​
 +            "​ip":​ "​127.0.0.1",​
 +            "​dns":​ "",​
 +            "​port":​ "​161",​
 +            "​bulk":​ "​1"​
 +        }
 +    ],
 +    "​id":​ 1
 +}
 +</​code>​
 +==== Смотрите также ====
 +
 +  * [[ru:​manual:​api:​reference:​host:​object#​узел_сети|Узел сети]]
 +  * [[ru:​manual:​api:​reference:​item:​object#​элемент_данных|Элемент данных]]
 +
 +==== Исходный код ====
 +
 +CHostInterface::​get() в //​frontends/​php/​include/​classes/​api/​services/​CHostInterface.php//​.