Documentation
Table of Contents
> Объект интерфейса узла сети
Следующие объекты напрямую связаны с 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 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. |
| privprotocol | integer | SNMPv3 privacy protocol. Used only by SNMPv3 interfaces. Possible values are: 0 - (default) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. |
| contextname | string | SNMPv3 context name. Used only by SNMPv3 interfaces. |