hostinterface.get

Apraksts

integer/array hostinterface.get(object parameters)

Metode ļauj izgūt hostu saskarnes atbilstoši norādītajiem parametriem.

Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object) Parametri, kas nosaka vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
hostids ID/array Atgriezt tikai hostu saskarnes, ko izmanto norādītie hosti.
interfaceids ID/array Atgriezt tikai hostu saskarnes ar norādītajiem ID.
itemids ID/array Atgriezt tikai hostu saskarnes, ko izmanto norādītie vienumi.
triggerids ID/array Atgriezt tikai hostu saskarnes, ko izmanto vienumi norādītajos trigeros.
selectItems query Atgriezt items īpašību ar vienumiem, kas izmanto saskarni.

Atbalsta count.
selectHosts query Atgriezt hosts īpašību ar hostu masīvu, kas izmanto saskarni.
limitSelects integer Ierobežo apakšatlases vaicājumu atgriezto ierakstu skaitu.

Attiecas uz šādām apakšatlasēm:
selectItems.
sortfield string/array Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: interfaceid, dns, ip.
countOutput boolean Šie parametri ir aprakstīti atsauces komentārā.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Atgrieztās vērtības

(integer/array) Atgriež vienu no šīm vērtībām:

  • objektu masīvu;
  • izgūto objektu skaitu, ja ir izmantots parametrs countOutput.

Piemēri

Iegūt hosta saskarnes

Iegūstiet visus datus par saskarnēm, ko izmanto hosts "30057."

Pieprasījums:

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

Atbilde:

{
    "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
}

Skatiet arī

Avots

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