hostinterface.get

Опис

integer/array hostinterface.get(object parameters)

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

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

Параметри

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

Parameter Type Опис
hostids ID/array Врати само интерфејсе домаћина које користе дати домаћини.
interfaceids ID/array Врати само интерфејсе домаћина са датим ID-ијевима.
itemids ID/array Врати само интерфејсе домаћина које користе дате ставке.
triggerids ID/array Врати само интерфејсе домаћина које користе ставке у датим окидачима.
selectItems query Врати својство [items](/manual/api/reference/host/object) са ставкама које користе интерфејс.

Подржава
count . | |selectHosts|query|Врати својство [hosts](/manual/api/reference/host/object) са низом домаћина који користе интерфејс.| |limitSelects|integer|Ограничава број записа које враћају подизбори .

selectItems се на сљедеће подизборе:
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
       }

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

Извор

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