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