dservice.get

Beschreibung

integer/array dservice.get(object parameters)

Mit dieser Methode können entdeckte Services entsprechend den angegebenen Parametern abgerufen werden.

Diese Methode ist für Benutzer aller Typen verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object) Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

Parameter Type Beschreibung
dserviceids ID/array Gibt nur entdeckte Services mit den angegebenen IDs zurück.
dhostids ID/array Gibt nur entdeckte Services zurück, die zu den angegebenen entdeckten Hosts gehören.
dcheckids ID/array Gibt nur entdeckte Services zurück, die durch die angegebenen Discovery-Prüfungen erkannt wurden.
druleids ID/array Gibt nur entdeckte Services zurück, die durch die angegebenen Discovery-Regeln erkannt wurden.
selectDRules query Gibt eine Eigenschaft drules mit einem Array der Discovery-Regeln zurück, die den Service erkannt haben.
selectDHosts query Gibt eine Eigenschaft dhosts mit einem Array der entdeckten Hosts zurück, zu denen der Service gehört.
selectHosts query Gibt eine Eigenschaft hosts mit den Hosts zurück, die dieselbe IP-Adresse und denselben Proxy wie der Service haben.

Unterstützt count.
limitSelects integer Begrenzt die Anzahl der von Unterabfragen zurückgegebenen Datensätze.

Gilt für die folgenden Unterabfragen:
selectHosts - das Ergebnis wird nach hostid sortiert.
sortfield string/array Sortiert das Ergebnis nach den angegebenen Eigenschaften.

Mögliche Werte: dserviceid, dhostid, ip.
countOutput boolean Diese Parameter sind in der Referenzkommentierung beschrieben.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Rückgabewerte

(integer/array) Kann die folgenden Dinge zurück geben:

  • ein Array von Objekten;
  • die Anzahl der abgerufenen Objekte, wenn der Parameter countOutput verwendet wurde.

Beispiele

Auf einem Host erkannte Services abrufen

Rufen Sie alle erkannten Services ab, die auf dem erkannten Host „11“ gefunden wurden.

Anfrage:

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

Antwort:

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

Siehe auch

Quelle

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