[comment]: # translation:outdated

[comment]: # ({7ed888d2-7ed888d2})
# > Объект интерфейса узла сети

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

[comment]: # ({/7ed888d2-7ed888d2})

[comment]: # ({133bde37-ce77a3b0})
### Интерфейс узла сети

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

::: noteimportant
Поля IP и DNS обязательны. Если DNS не используется, укажите его как пустую строку.
:::

|Свойство|[Тип](/manual/api/reference_commentary#тип_данных)|Описание|
|--|--|------|
|available|integer|*(только для чтения)* - доступность интерфейса узла сети.<br><br>Возможные значения:<br>0 - *(по умолчанию)* неизвестно;<br>1 - доступен;<br>2 - недоступен.|
|details|object|Дополнительный объект для интерфейса. **Обязательно** , если тип интерфейса - SNMP.|
|disable\_until|timestamp|*(только для чтения)* - время следующей проверки недоступного интерфейса узла сети.|
|**dns**<br>(обязательно)|string|DNS-имя, используемое интерфейсом.<br><br>Может быть пустым, если соединение выполняется по IP.|
|error|string|*(только для чтения)* - текст ошибки, если интерфейс недоступен.|
|errors\_from|timestamp|*(только для чтения)* - время, когда интерфейс узла сети стал недоступен.|
|**hostid**<br>(обязательно)|string|Идентификатор узла сети, которому принадлежит интерфейс.|
|interfaceid|string|*(только для чтения)* - идентификатор интерфейса.|
|**ip**<br>(обязательно)|string|IP-адрес, используемый интерфейсом.<br><br>Может быть пустым, если соединение выполняется по DNS.|
|**main**<br>(обязательно)|integer|Используется ли интерфейс как основной для узла. Для каждого типа интерфейса может быть только один основной.<br><br>Возможные значения:<br>0 - не основной;<br>1 - основной.|
|**port**<br>(обязательно)|string|Номер порта, используемый интерфейсом. Может содержать пользовательские макросы.|
|**type**<br>(обязательно)|integer|Тип интерфейса.<br><br>Возможные значения:<br>1 - агент;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>|
|**useip**<br>(обязательно)|integer|Определяет, выполняется ли подключение по IP.<br><br>Возможные значения:<br>0 - подключение по DNS-имени узла;<br>1 - подключение по IP-адресу узла для этого интерфейса.|

Обратите внимание, что для некоторых методов (например, update и delete) набор обязательных и необязательных параметров отличается.

[comment]: # ({/133bde37-ce77a3b0})

[comment]: # ({new-3bb71fcc})
### Details tag

The details object has the following properties.

|Property|[Type](/manual/api/reference_commentary#data_types)|Description|
|--------|---------------------------------------------------|-----------|
|**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3|
|bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>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.<br><br>Possible values are:<br>0 - (default) - noAuthNoPriv;<br>1 - authNoPriv;<br>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.<br><br>Possible values are:<br>0 - (default) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.|
|privprotocol|integer|SNMPv3 privacy protocol. Used only by SNMPv3 interfaces.<br><br>Possible values are:<br>0 - (default) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.|
|contextname|string|SNMPv3 context name. Used only by SNMPv3 interfaces.|

[comment]: # ({/new-3bb71fcc})