dservice.get

Опис

integer/array dservice.get(object parameters)

Метод дозволяє отримати виявлені сервіси за заданими параметрами.

Цей спосіб доступний користувачам будь-якого типу. Дозволи на виклик методу можна скасувати в налаштуваннях ролі користувача. Див. Ролі користувача для отримання додаткової інформації.

Параметри

(object) Параметри, що визначають бажаний результат.

Метод підтримує такі параметри.

Параметр	Тип	Опис
dserviceids	рядок/масив	Повернути лише виявлені служби з указаними ідентифікаторами.
dhostids	рядок/масив	Повертає лише виявлені служби, які належать вказаним виявленим хостам.
dcheckids	рядок/масив	Повертати лише виявлені служби, які були виявлені вказаними перевірками виявлення.
druleids	рядок/масив	Повертати лише виявлені служби, які були виявлені за вказаними правилами виявлення.
selectDRules	запит	Повернути властивість drules із масивом правил виявлення, які виявили службу.
selectDHosts	запит	Повернути властивість dhosts із масивом виявлених хостів, до яких належить служба.
selectHosts	запит	Повертає властивість hosts із хостами з тією самою IP-адресою та проксі-сервером, що й служба. Підтримує `count`.
limitSelects	ціле число	Обмежує кількість записів, що повертаються підвиборами. Застосовується до наступних підвиборів: `selectHosts` - результат буде відсортовано за `hostid`.
sortfield	рядок/масив	Відсортуйте результат за заданими властивостями. Можливі значення: `dserviceid`, `dhostid` та `ip`.
countOutput	boolean	Ці параметри, які є спільними для всіх методів `get`, детально описані в довідковому коментарі.
редагований	логічний
excludeSearch	boolean
фільтр	об'єкт
ліміт	ціле
вивід	запит
preservekeys	boolean
пошук	об'єкт
searchByAny	логічний
увімкнено знаки підстановки	логічний
порядок сортування	рядок/масив
почати пошук	логічний

Повернуті значення

(integer/array) Повертає або:

масив об'єктів;
кількість отриманих об'єктів, якщо використовувався параметр countOutput.

Приклади

Отримати служби, виявлені на хості

Отримати всі виявлені служби, виявлені на виявленому хості "11".

Запит:

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

Відповідь:

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

Дивись також

Джерело

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

Documentation