hostinterface.get

Опис

integer/array hostinterface.get(object parameters)

Метод омогућава преузимање интерфејса домаћина према датим параметрима.

Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Userroles за више информација.

Параметри

(object) Параметри који дефинишу жељени излаз.

Метода подржава следеће параметре.

Parameter	Type	Description
hostids	ID/array	Врати само интерфејсе домаћина које користе дати домаћина.
interfaceids	ID/array	Врати само интерфејсе домаћина са датим ID-ијевима.
itemids	ID/array	Врати само интерфејсе хоста које користе дати елементи.
triggerids	ID/array	Врати само интерфејсе домаћина које користе елементи у датим окидачима.
selectItems	query	Врати својство `items` са елементима који користе интерфејс. Подржава `count`.
selectHosts	query	Враћа својство `hosts` са низом домаћина који користе интерфејс.
limitSelects	integer	Ограничава број записа које враћају подизбори. Односи се на следеће подизборе: `selectItems`.
sortfield	string/array	Сортира резултат по датим својствима. Могуће вредности: `interfaceid`, `dns`, `ip`.
countOutput	boolean	Ови параметри су описани у коментару референце.
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Повратне вредности

(integer/array) Враћа било:

низ објеката;
број преузетих објеката, ако је параметар countOutput коришћен.

Примери

Преузимање интерфејса домаћина

Преузми све податке о интерфејсима које користи домаћин "30057."

Request:

{
            "jsonrpc": "2.0",
            "method": "hostinterface.get",
            "params": {
            "output": "extend",
            "hostids": "30057"
            },
            "id": 1
       }

Одговор:

{
            "jsonrpc": "2.0",
            "result": [
            {
            "interfaceid": "50039",
            "hostid": "30057",
            "main": "1",
            "type": "1",
            "useip": "0",
            "ip": "",
            "dns": "localhost",
            "port": "10050",
            "available": "0",
            "error": "",
            "errors_from": "0",
            "disable_until": "0",
            "details": []
            },
            {
            "interfaceid": "55082",
            "hostid": "30057",
            "main": "1",
            "type": "2",
            "useip": "1",
            "ip": "127.0.0.1",
            "dns": "",
            "port": "161",
            "available": "0",
            "error": "",
            "errors_from": "0",
            "disable_until": "0",
            "details": {
            "version": "2",
            "bulk": "0",
            "community": "{$SNMP_COMMUNITY}",
            "max_repetitions": "10"
            }
            }
            ],
            "id": 1
       }

Такође погледајте

Host
Item

Извор

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

Documentation