proxy.create

Описание

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

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

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) Прокси для создания.

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

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

Для узлов сети должно быть определено только свойство hostid.

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

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

Примеры

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

Создайте активный прокси "Active proxy" и назначьте ему узел сети для мониторинга.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "operating_mode": "0",
        "hosts": [
            {
                "hostid": "10279"
            }
        ]
    },
    "id": 1
}

Ответ:

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

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

Создайте пассивный прокси "Passive proxy" и назначьте ему два узла сети для мониторинга.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Passive proxy",
        "operating_mode": "1",
        "address": "127.0.0.1",
        "port": "10051",
        "hosts": [
            {
                "hostid": "10192"
            },
            {
                "hostid": "10139"
            }
        ]
    },
    "id": 1
}

Ответ:

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

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

Создайте активный прокси "Active proxy" и добавьте его в группу прокси с ID "1".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "proxy.create",
    "params": {
        "name": "Active proxy",
        "proxy_groupid": "1",
        "operating_mode": "0"
    },
    "id": 1
}

Ответ:

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

См. также

Источник

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