Zabbix Documentation 4.4

3.04.05.0 (current)| In development:5.2 (devel)| Unsupported:1.82.02.22.43.23.44.24.4Guidelines

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

Both sides previous revision Previous revision
Previous revision
Last revision Both sides next revision
ru:manual:api:reference:hostinterface:get [2017/01/04 20:14]
ru:manual:api:reference:hostinterface:get [2019/12/25 09:49]
dotneft
Line 1: Line 1:
 +===== hostinterface.get =====
  
 +==== Описание ====
 +
 +''​целое число/​массив hostinterface.get(объект **параметры**)''​
 +
 +Этот метод позволяет получать интерфейсы узлов сети в соответствии с заданными параметрами.
 +
 +==== Параметры ====
 +
 +''​(объект)''​ Параметры задают желаемый вывод.
 +
 +Этот метод поддерживает следующие параметры.
 +
 +^ Параметр ^ Тип ^ Описание ^
 +| hostids | строка/​массив | Возврат только тех интерфейсов узлов сети, которые используются заданными узлами сети. |
 +| interfaceids | строка/​массив | Возврат интерфейсов узлов сети только с заданными IDs. |
 +| itemids | строка/​массив | Возврат только тех интерфейсов узлов сети, которые используются заданными элементами данных. |
 +| triggerids | строка/​массив | Возврат только тех узлов сети, которые используются элементами данных в заданных триггерах. |
 +^ |||
 +| selectItems | запрос | Возврат свойства ''​[[:​manual/​api/​reference/​host/​object|items]]''​ с элементами данных,​ которые используют этот интерфейс. \\ \\ Поддерживается ''​count''​. | 
 +| selectHosts | запрос | Возврат свойства ''​[[:​manual/​api/​reference/​host/​object|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//​.