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
       }

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

Извор

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