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

Следующие объекты напрямую связаны с 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.

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

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

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

Возможные значения: 1–2147483647 (INT32_MAX).
Значение по умолчанию: 10.
retries string Максимальное количество повторных попыток, если время ожидания запроса истекло.
Используется элементами данных walk[] и get[]. Для walk[] повторные попытки распределяются по всему обходу.
Поддерживаются пользовательские макросы.

Возможные значения: 0–100 (0 - отключить повторные попытки).
Значение по умолчанию: 5.
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.