Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

hostinterface.create

Описание

объект hostinterface.create(объект/массив hostInterfaces)

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

Этот метод доступен для пользователей типа Admin и Super admin. Разрешения на вызов метода могут быть отозваны в настройках роли пользователя. Смотрите Роли пользователя для получения дополнительной информации.

Параметры

(объект/массив) Создаваемые интерфейсы узлов сети. Этот метод принимает интерфейсы узлов сети со стандартными свойствами интерфейсов узлов сети.

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

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

Примеры

Создание нового интерфейа

Создайте второй IP интерфейс агента на узле сети "30052".

Запрос:

{
           "jsonrpc": "2.0",
           "method": "hostinterface.create",
           "params": {
               "hostid": "30052",
               "main": "0",
               "type": "1",
               "useip": "1",
               "ip": "127.0.0.1",
               "dns": "",
               "port": "10050",
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "interfaceids": [
                   "30062"
               ]
           },
           "id": 1
       }

Создание интерфейса со сведениями SNMP

Запрос:

{
           "jsonrpc": "2.0",
           "method": "hostinterface.create",
           "params": {
               "hostid": "10456",
               "main": "0",
               "type": "2",
               "useip": "1",
               "ip": "127.0.0.1",
               "dns": "",
               "port": "1601",
               "details": {
                   "version": "2",
                   "bulk": "1",
                   "community": "{$SNMP_COMMUNITY}"
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": {
               "interfaceids": [
                   "30063"
               ]
           },
           "id": 1
       }

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

Исходный код

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