dservice.get

Descrizione

integer/array dservice.get(object parameters)

Questo metodo consente di recuperare i servizi rilevati in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere Ruoli utente per ulteriori informazioni.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Type Descrizione
dserviceids ID/array Restituisce solo i servizi rilevati con gli ID specificati.
dhostids ID/array Restituisce solo i servizi rilevati che appartengono agli host rilevati specificati.
dcheckids ID/array Restituisce solo i servizi rilevati che sono stati individuati dai controlli di discovery specificati.
druleids ID/array Restituisce solo i servizi rilevati che sono stati individuati dalle regole di discovery specificate.
selectDRules query Restituisce una proprietà drules con un array delle regole di discovery che hanno individuato il servizio.
selectDHosts query Restituisce una proprietà dhosts con un array degli host rilevati a cui appartiene il servizio.
selectHosts query Restituisce una proprietà hosts con gli host con lo stesso indirizzo IP e proxy del servizio.

Supporta count.
limitSelects integer Limita il numero di record restituiti dalle sotto-selezioni.

Si applica alle seguenti sotto-selezioni:
selectHosts - il risultato sarà ordinato per hostid.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: dserviceid, dhostid, ip.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valori restituiti

(integer/array) Restituisce o:

  • una matrice di oggetti;
  • il conteggio degli oggetti recuperati, se il parametro countOutput è stato usato.

Esempi

Recuperare i servizi rilevati su un host

Recupera tutti i servizi rilevati individuati sull'host rilevato "11".

Richiesta:

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

Risposta:

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

Vedi anche

Fonte

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