dservice.get

Apraksts

integer/array dservice.get(object parameters)

Metode ļauj izgūt atklātos servisus 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 Lietotāju lomas.

Parametri

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

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
dserviceids ID/array Atgriezt tikai atklātos servisus ar norādītajiem ID.
dhostids ID/array Atgriezt tikai atklātos servisus, kas pieder norādītajiem atklātajiem hostiem.
dcheckids ID/array Atgriezt tikai atklātos servisus, kurus ir noteikušas norādītās atklāšanas pārbaudes.
druleids ID/array Atgriezt tikai atklātos servisus, kurus ir noteikuši norādītie atklāšanas noteikumi.
selectDRules query Atgriezt drules īpašību ar atklāšanas noteikumu masīvu, kas noteica servisu.
selectDHosts query Atgriezt dhosts īpašību ar atklāto hostu masīvu, kuriem serviss pieder.
selectHosts query Atgriezt hosts īpašību ar hostiem, kuriem ir tāda pati IP adrese un starpniekserveris kā servisam.

Atbalsta count.
limitSelects integer Ierobežo apakšatlases vaicājumos atgriezto ierakstu skaitu.

Attiecas uz šādām apakšatlasēm:
selectHosts - rezultāts tiks kārtots pēc hostid.
sortfield string/array Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: dserviceid, dhostid, 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

Atgūt hostā atklātos servisus

Atgūt visus atklātos servisus, kas noteikti atklātajā hostā "11".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "dservice.get",
    "params": {
        "output": "extend",
        "dhostids": "11"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "dserviceid": "12",
            "dhostid": "11",
            "value": "",
            "port": "80",
            "status": "1",
            "lastup": "0",
            "lastdown": "1348650607",
            "dcheckid": "5",
            "ip": "192.168.1.134",
            "dns": "john.local"
        },
        {
            "dserviceid": "13",
            "dhostid": "11",
            "value": "",
            "port": "21",
            "status": "1",
            "lastup": "0",
            "lastdown": "1348650610",
            "dcheckid": "6",
            "ip": "192.168.1.134",
            "dns": "john.local"
        }
    ],
    "id": 1
}

Skatīt arī

Avots

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