dservice.get

Opis

integer/array dservice.get(object parameters)

Metoda pozwala na pobranie wykrytych usług zgodnie z żądanymi parametrami.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz Role użytkownika po więcej informacji.

Parametry

(object) Parametry określające pożądany wynik.

Metoda obsługuje następujące parametry.

Parametr	Typ	Opis
dserviceids	string/array	Zwraca tylko wykryte usługi o podanych identyfikatorach.
dhostids	string/array	Zwraca tylko wykryte usługi, które należą do podanych wykrytych hostów.
dcheckids	string/array	Zwraca tylko wykryte usługi, które zostały wykryte przez podane testy wykrywania.
druleids	string/array	Zwraca tylko wykryte usługi, które zostały wykryte przez podane reguły wykrywania.
selectDRules	query	Zwraca właściwość drules z tablicą reguł wykrywania, które wykryły usługę.
selectDHosts	query	Zwraca właściwość dhosts z wykrytymi hostami utworzonymi przez regułę wykrywania.
selectHosts	query	Zwraca właściwość hosts z hostami o tym samym adresie IP i proxy co usługa. Obsługuje `count`.
limitSelects	integer	Ogranicza liczbę rekordów zwracanych przez podwybory. Dotyczy następujących podwyborów: `selectHosts` - wynik zostanie posortowany według `hostid`.
sortfield	string/array	Sortuj wynik według podanych właściwości. Możliwe wartości to: `dserviceid`, `dhostid` i `ip`.
countOutput	boolean	Parametry te są wspólne dla wszystkich metod `get` i są szczegółowo 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 jedną z opcji:

tablicę obiektów;
liczbę pobranych obiektów, jeśli parametr countOutput został wykorzystany.

Przykłady

Pobierz usługi wykryte na hoście

Pobiera wszystkie wykryte usługi odkryte na wykrytym hoście "11".

Zapytanie:

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

Documentation