# proxy.create

### Описание

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

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

### Параметры

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

В дополнение к [стандартным свойствам прокси](object#прокси), этот метод
принимает следующие параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|hosts|массив|Узлы сети для наблюдения через прокси. Если узел сети уже наблюдается другим прокси, он будет переназначен на текущий прокси.<br><br>У узлов сети должно быть задано свойство `hostid`.|
|interface|объект|Создаваемый интерфейс узла сети для пассивного прокси.<br><br>Требуется для пассивных прокси.|
|~~interfaces~~<br>(устаревший)|массив|Создаваемый интерфейс узла сети для пассивного прокси в виде массива.|

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

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

### Примеры

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

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

Запрос:

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

Ответ:

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

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

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

Запрос:

``` {.java}
{
    "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
}
```

Ответ:

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

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

-   [Узел сети](/ru/manual/api/reference/host/object#узел_сети)
-   [Интерфейс прокси](object#интерфейс_прокси)

### Исходный код

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