proxy.create

Описание

объект proxy.create(объект/массив прокси)

Этот метод позволяет создавать новые прокси.

Параметры

(объект/массив) Создаваемые прокси.

В дополнение к стандартным свойствам прокси, этот метод принимает следующие параметры.

Параметр Тип Описание
hosts массив Узлы сети для наблюдения через прокси. Если узел сети уже наблюдается другим прокси, он будет переназначен на текущий прокси.

У узлов сети должно быть задано свойство hostid.
interface объект Создаваемый интерфейс узла сети для пассивного прокси.

Требуется для пассивных прокси.
interfaces
(устаревший)
массив Создаваемый интерфейс узла сети для пассивного прокси в виде массива.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных прокси под свойством proxyids. Порядок возвращаемых ID совпадает с порядком переданных прокси.

Примеры

Создание активного прокси

Создание активного прокси "Active proxy" и назначение узла сети для наблюдения через этот прокси.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Active proxy",
               "status": "5",
               "hosts": [
                   {
                       "hostid": "10279"
                   }
               ]
           },
           "auth": "ab9638041ec6922cb14b07982b268f47",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10280"
               ]
           },
           "id": 1
       }

Создание пассивного прокси

Создание пассивного прокси "Passive proxy" и назначение двух узлов сети для наблюдения через этот прокси.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "proxy.create",
           "params": {
               "host": "Passive proxy",
               "status": "6",
               "interface": {
                   "ip": "127.0.0.1",
                   "dns": "",
                   "useip": "1",
                   "port": "10051"
               },
               "hosts": [
                   {
                       "hostid": "10192"
                   },
                   {
                       "hostid": "10139"
                   }
               ]
           },
           "auth": "ab9638041ec6922cb14b07982b268f47",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "proxyids": [
                   "10284"
               ]
           },
           "id": 1
       }

Смотрите также

Исходный код

CProxy::create() в frontends/php/include/classes/api/services/CProxy.php.