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

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

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

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

Свойство Тип Описание
interfaceid ID Идентификатор интерфейса.

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

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

Поведение свойства:
- только для чтения
hostid 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 community. Используется только интерфейсами 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.