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

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

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

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

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

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

Свойство Тип Описание
interfaceid строка (только чтение) ID интерфейса.
dns
(требуется)
строка DNS имя используемое интерфейсом.

Может быть пустым, если соединение выполняется через IP.
hostid
(требуется)
строка ID узла сети, которому принадлежит интерфейс.
ip
(требуется)
строка IP адрес используемый интерфейсом.

Может быть пустым, если соединение выполняется через DNS.
main
(требуется)
целое число Является ли интерфейс используемым по умолчанию на узле сети. На узле сети в качестве умолчания может быть задан только один интерфейс каждого типа.

Возможные значения:
0 - не по умолчанию;
1 - по умолчанию.
port
(требуется)
строка Номер порта используемого интерфейсом. Может содержать пользовательские макросы.
type
(требуется)
целое число Тип интерфейса.

Возможные значения:
1 - агент;
2 - SNMP;
3 - IPMI;
4 - JMX.
useip
(требуется)
целое число Должно ли соединение выполняться через IP адрес.

Возможные значения:
0 - подключение с использованием DNS имени хоста;
1 - подключение с использованием IP адреса хоста.
bulk целое число Необходимо ли использовать массовые запросы SNMP.

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

Details tag

The details object has the following properties.

Property Type Description
version
(required)
integer SNMP interface version.

Possible values are:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk integer Whether to use bulk SNMP requests.

Possible values are:
0 - don't use bulk requests;
1 - (default) - use bulk requests.
community string SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.
securityname string SNMPv3 security name. Used only by SNMPv3 interfaces.
securitylevel integer SNMPv3 security level. Used only by SNMPv3 interfaces.

Possible values are:
0 - (default) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string SNMPv3 authentication passphrase. Used only by SNMPv3 interfaces.
privpassphrase string SNMPv3 privacy passphrase. Used only by SNMPv3 interfaces.
authprotocol integer SNMPv3 authentication protocol. Used only by SNMPv3 interfaces.

Possible values are:
0 - (default) - MD5;
1 - SHA.
privprotocol integer SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.

Possible values are:
0 - (default) - DES;
1 - AES.
contextname string SNMPv3 context name. Used only by SNMPv3 interfaces.