dservice.get

Descripció

integer/array dservice.get(object parameters)

El mètode permet recuperar serveis descoberts segons els paràmetres proveïts.

Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu Rols d'usuari.

Paràmetres

(object) Paràmetres que defineixen la sortida esperada.

El mètode admet els paràmetres següents:

Paràmatre	Tipus	Descripció
dserviceids	ID/array	Retorna només els serveis descoberts amb els IDs donats.
dhostids	ID/array	Retorna només els serveis descoberts que pertanyen als equips descoberts demanats.
dcheckids	ID/array	Retorna només els serveis descoberts que han estat detectats pels tests de descoberta donats.
druleids	ID/array	Retorna només els serveis descoberts creats per les regles de descoberta donats.
selectDRules	query	Retorna una propietat `drules` amb una taula de les regles de descoberta que han detectat el servei.
selectDHosts	query	Retorna una propietat `dhosts` amb una taula dels equips descoberts als qui pertany el servei.
selectHosts	query	Retorna una propietat `hosts` amb els equips que tenen la mateixa adreça IP i el mateix proxy que el servei. Admet `count`.
limitSelects	integer	Limita el nombre d'enregistraments retornats per les sub-seleccions. Aplica a les sub-seleccions següents: `selectHosts` - el resultat s'endreçarà per `hostid`.
sortfield	string/array	Ordena el resultat per les propietats proporcionades. Els valors possibles són:`dserviceid`, `dhostid` i `ip`.
countOutput	boolean	Aquests paràmetres són descrits als comentaris de referència.
editable	boolean
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Valors de retorn

(integer/array) Retorna un d'entre:

una taula d'objectes;
el recompte d'objectes recuperats, si s'empra el paràmetre countOutput.

Exemples

Recuperar els serveis descoberts d'un equip

Recuperar tots els serveis descoberts de l'equip "11".

Petició:

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

Resposta:

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

Veieu també

Font

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

Documentation