This is a translation of the original English documentation page. Help us make it better.

dservice.get

Beschrijving

integer/array dservice.get(objectparameters)

De methode maakt het mogelijk om ontdekte services op te halen volgens de gegeven parameters.

Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.

Parameters

(object) Parameters die de gewenste uitvoer definiëren.

De methode ondersteunt de volgende parameters.

Parameter Type Beschrijving
dserviceids string/array Geef alleen ontdekte services terug met de opgegeven IDs.
dhostids string/array Geef alleen ontdekte services terug die behoren tot de opgegeven ontdekte hosts.
dcheckids string/array Geef alleen ontdekte services terug die gedetecteerd zijn door de opgegeven ontdekkingscontroles.
druleids string/array Geef alleen ontdekte services terug die gedetecteerd zijn door de opgegeven ontdekkingsregels.
selectDRules query Geef een eigenschap drules terug met een reeks ontdekkingsregels die de service hebben gedetecteerd.
selectDHosts query Geef een eigenschap dhosts terug met een reeks ontdekte hosts waartoe de service behoort.
selectHosts query Geef een eigenschap hosts terug met de hosts met hetzelfde IP-adres en proxy als de service.

Ondersteunt count.
limitSelects integer Beperkt het aantal records dat wordt geretourneerd door subselecties.

Van toepassing op de volgende subselecties:
selectHosts - het resultaat wordt gesorteerd op hostid.
sortfield string/array Sorteer het resultaat op basis van de opgegeven eigenschappen.

Mogelijke waarden: dserviceid, dhostid, ip.
countOutput boolean Deze parameters, die gemeenschappelijk zijn voor alle get-methoden, worden in detail beschreven in het referentiecommentaar.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Retourwaarden

(integer/array) Retourneert ofwel:

  • een reeks objecten;
  • het aantal opgehaalde objecten, als de countOutput parameter heeft gebruikt.

Voorbeelden

Ontdekte services ophalen op een host

Haal alle ontdekte services op die gedetecteerd zijn op ontdekte host "11".

Aanvraag:

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

Reactie:

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

Zie ook

Bron

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