dhost.get

Опис

integer/array dcheck.get(object parameters)

Метод омогућава преузимање контролних табли према датим параметрима.

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

Параметри

(object) Параметри који дефинишу жељени излаз. Метод подржава следеће параметре. Parameter Type Description
dhostids ID/array Враћа само откривене домаћине са датим ID-ијевима.
druleids ID/array Враћа само откривене домаћине који су креирани према датим правилима откривања.
dserviceids ID/array Враћа само откривене домаћине који покрећу дате услуге.
selectDRules query Враћа својство drules са низом правила откривања која су открила домаћина.
selectDServices query Враћа својство dservices са откривеним услугама које раде на домаћину.

Подржава count.
limitSelects integer Ограничава број записа које враћају подизбори.

Односи се на следеће подизборе:
selectDServices - резултати ће бити сортирани према dserviceid.
sortfield string/array Сортирај резултат према датим особинама.

Могуће вредности: dhostid, druleid.
countOutput boolean Ови параметри који су описани у [референтном коментару]
(/manual/api/reference_commentary#common_get_method_parameters).

|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 коришћен.

Примери

Преузми откривене домаћине по правилу откривања

Преузми све домаћине и откривене услуге које покрећу, а које су откривене правилом откривања "4".

Request:

{
     "jsonrpc": "2.0",
     "method": "dhost.get",
     "params": {
     "output": "extend",
     "selectDServices": "extend",
     "druleids": "4"
},
     "id": 1
}

Одговор:

{
     "jsonrpc": "2.0",
     "result": [
     {
     "dservices": [
     {
     "dserviceid": "1",
     "dhostid": "1",
     "type": "4",
     "key_": "",
     "value": "",
     "port": "80",
     "status": "0",
     "lastup": "1337697227",
     "lastdown": "0",
     "dcheckid": "5",
     "ip": "192.168.1.1",
     "dns": "station.company.lan"
     }
     ],
     "dhostid": "1",
     "druleid": "4",
     "status": "0",
     "lastup": "1337697227",
     "lastdown": "0"
     },
     {
     "dservices": [
     {
     "dserviceid": "2",
     "dhostid": "2",
     "type": "4",
     "key_": "",
     "value": "",
     "port": "80",
     "status": "0",
     "lastup": "1337697234",
     "lastdown": "0",
     "dcheckid": "5",
     "ip": "192.168.1.4",
     "dns": "john.company.lan"
     }
     ],
     "dhostid": "2",
     "druleid": "4",
     "status": "0",
     "lastup": "1337697234",
     "lastdown": "0"
     },
     {
     "dservices": [
     {
     "dserviceid": "3",
     "dhostid": "3",
     "type": "4",
     "key_": "",
     "value": "",
     "port": "80",
     "status": "0",
     "lastup": "1337697234",
     "lastdown": "0",
     "dcheckid": "5",
     "ip": "192.168.1.26",
     "dns": "printer.company.lan"
     }
     ],
     "dhostid": "3",
     "druleid": "4",
     "status": "0",
     "lastup": "1337697234",
     "lastdown": "0"
     },
     {
     "dservices": [
     {
     "dserviceid": "4",
     "dhostid": "4",
     "type": "4",
     "key_": "",
     "value": "",
     "port": "80",
     "status": "0",
     "lastup": "1337697234",
     "lastdown": "0",
     "dcheckid": "5",
     "ip": "192.168.1.7",
     "dns": "mail.company.lan"
     }
     ],
     "dhostid": "4",
     "druleid": "4",
     "status": "0",
     "lastup": "1337697234",
     "lastdown": "0"
     }
     ],
     "id": 1
}

Погледајте такође

Извор

CDHost::get() у ui/include/classes/api/services/CDHost.php.