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.