Объект интерфейса узла сети

Следующие объекты напрямую связаны с API hostinterface.

Интерфейс узла сети

Объект интерфейса узла сети имеет следующие свойства.

Обратите внимание, что свойства ip и dns обязательны для операций создания. Если вы не хотите использовать DNS, установите для него пустую строку.

Свойство Type Описание
interfaceid ID ID интерфейса.

Поведение свойства:
- только для чтения
- обязательно для операций обновления
available integer Доступность интерфейса узла сети.

Возможные значения:
0 - (по умолчанию) неизвестно;
1 - доступен;
2 - недоступен.

Поведение свойства:
- только для чтения
hostid ID ID узла сети, которому принадлежит интерфейс.

Поведение свойства:
- константа
- обязательно для операций создания
type integer Тип интерфейса.

Возможные значения:
1 - Агент;
2 - SNMP;
3 - IPMI;
4 - JMX.

Поведение свойства:
- обязательно для операций создания
ip string IP-адрес, используемый интерфейсом.

Может быть пустым, если подключение выполняется через DNS.

Поведение свойства:
- обязательно для операций создания
dns string DNS-имя, используемое интерфейсом.

Может быть пустым, если подключение выполняется через IP.

Поведение свойства:
- обязательно для операций создания
port string Номер порта, используемый интерфейсом.
Может содержать пользовательские макросы.

Поведение свойства:
- обязательно для операций создания
useip integer Следует ли выполнять подключение через IP.

Возможные значения:
0 - подключаться, используя DNS-имя узла сети;
1 - подключаться, используя IP-адрес узла сети.

Поведение свойства:
- обязательно для операций создания
main integer Используется ли интерфейс как интерфейс по умолчанию на узле сети. Только один интерфейс определенного типа может быть установлен как интерфейс по умолчанию на узле сети.

Возможные значения:
0 - не по умолчанию;
1 - по умолчанию.

Поведение свойства:
- обязательно для операций создания
details object Дополнительный объект details для интерфейса.

Поведение свойства:
- обязательно, если type установлен в "SNMP"
disable_until timestamp Время следующего опроса недоступного интерфейса узла сети.

Поведение свойства:
- только для чтения
error string Текст ошибки, если интерфейс узла сети недоступен.

Поведение свойства:
- только для чтения
errors_from timestamp Время, когда интерфейс узла сети стал недоступен.

Поведение свойства:
- только для чтения

Подробности

Объект details имеет следующие свойства.

Свойство Тип Описание
version integer Версия интерфейса SNMP.

Возможные значения:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Поведение свойства:
- обязательно
bulk integer Следует ли использовать групповые SNMP-запросы.

Возможные значения:
0 - не использовать групповые запросы;
1 - (по умолчанию) - использовать групповые запросы.
community string Community SNMP. Используется только интерфейсами SNMPv1 и SNMPv2.

Поведение свойства:
- обязательно, если version установлено в "SNMPv1" или "SNMPv2c"
max_repetitions integer Максимальное значение повторений для встроенных групповых SNMP-запросов (GetBulkRequest-PDUs).
Используется только для элементов данных discovery[] и walk[] в SNMPv2 и v3.

По умолчанию: 10.
securityname string Имя безопасности SNMPv3. Используется только интерфейсами SNMPv3.
securitylevel integer Уровень безопасности SNMPv3. Используется только интерфейсами SNMPv3.

Возможные значения:
0 - (по умолчанию) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Парольная фраза аутентификации SNMPv3. Используется только интерфейсами SNMPv3.
privpassphrase string Парольная фраза приватности SNMPv3. Используется только интерфейсами SNMPv3.
authprotocol integer Протокол аутентификации SNMPv3. Используется только интерфейсами SNMPv3.

Возможные значения:
0 - (по умолчанию) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer Протокол приватности SNMPv3. Используется только интерфейсами SNMPv3.

Возможные значения:
0 - (по умолчанию) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string Имя контекста SNMPv3. Используется только интерфейсами SNMPv3.