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	string/array	Retorna només els serveis descoberts amb els IDs donats.
dhostids	string/array	Retorna només els serveis descoberts que pertanyen als equips descoberts demanats.
dcheckids	string/array	Retorna només els serveis descoberts que han estat detectats pels tests de descoberta donats.
druleids	string/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	rRetorna 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, comuns a tots els mètodes `get`, 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

Recupera els serveis descoberts a un equip

Recupera tots els serveis detectats a l'equip descobert "11".

Petició:

{
           "jsonrpc": "2.0",
           "method": "dservice.get",
           "params": {
               "output": "extend",
               "dhostids": "11"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "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