dservice.get

Opis

integer/array dservice.get(object parameters)

Ta metoda umożliwia pobranie wykrytych usług zgodnie z podanymi parametrami.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji User roles.

Parametry

(object) Parametry definiujące żądane dane wyjściowe.

Metoda obsługuje następujące parametry.

Parametr Typ Opis
dserviceids ID/array Zwraca tylko wykryte usługi o podanych identyfikatorach.
dhostids ID/array Zwraca tylko wykryte usługi należące do podanych wykrytych hostów.
dcheckids ID/array Zwraca tylko wykryte usługi, które zostały wykryte przez podane kontrole wykrywania.
druleids ID/array Zwraca tylko wykryte usługi, które zostały wykryte przez podane reguły wykrywania.
selectDRules query Zwraca właściwość drules zawierającą tablicę reguł wykrywania, które wykryły usługę.
selectDHosts query Zwraca właściwość dhosts zawierającą tablicę wykrytych hostów, do których należy usługa.
selectHosts query Zwraca właściwość hosts zawierającą hosty z tym samym adresem IP i proxy co usługa.

Obsługuje count.
limitSelects integer Ogranicza liczbę rekordów zwracanych przez podzapytania.

Dotyczy następujących podzapytań:
selectHosts - wynik zostanie posortowany według hostid.
sortfield string/array Sortuje wynik według podanych właściwości.

Możliwe wartości: dserviceid, dhostid, ip.
countOutput boolean Te parametry są opisane w komentarzu referencyjnym.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Zwracane wartości

(integer/array) Zwraca:

  • tablicę obiektów;
  • liczbę pobranych obiektów, jeśli został użyty parametr countOutput.

Przykłady

Pobieranie usług wykrytych na hoście

Pobierz wszystkie wykryte usługi znalezione na wykrytym hoście „11”.

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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