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

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

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

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

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

Property Type Description
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 имеет следующие свойства.

Property Type Description
version integer Версия интерфейса SNMP.

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

Поведение свойства:
- required
bulk integer Использовать ли массовые запросы SNMP.

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

Поведение свойства:
- required если version установлено в "SNMPv1" или "SNMPv2c"
max_repetitions integer Максимальное значение повторений для нативных массовых запросов SNMP (PDU GetBulkRequest).
Используется только для элементов данных 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.