[comment]: # aside: 1

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

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

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

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

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

::: noteimportant
Обратите внимание, что свойства `ip` и `dns` являются *обязательными* для операций создания.
Если вы не хотите использовать DNS, задайте для него пустую строку.
:::

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

[comment]: # ({/2e033569-ce77a3b0})

[comment]: # ({58c84008-3bb71fcc})
#### Подробности

Объект details имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|version|integer|Версия интерфейса SNMP.<br><br>Возможные значения:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|bulk|integer|Использовать ли массовые запросы SNMP.<br><br>Возможные значения:<br>0 - не использовать массовые запросы;<br>1 - (по умолчанию) - использовать массовые запросы.|
|community|string|Сообщество SNMP. Используется только интерфейсами SNMPv1 и SNMPv2.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *required* если `version` установлено в "SNMPv1" или "SNMPv2c"|
|max_repetitions|integer|Максимальное значение повторений для [нативных массовых запросов SNMP](#native-snmp-bulk-requests) (PDU GetBulkRequest).<br>Используется только для элементов данных `discovery[]` и `walk[]` в SNMPv2 и v3.<br><br>По умолчанию: 10.|
|securityname|string|Имя безопасности SNMPv3. Используется только интерфейсами SNMPv3.|
|securitylevel|integer|Уровень безопасности SNMPv3. Используется только интерфейсами SNMPv3.<br><br>Возможные значения:<br>0 - (по умолчанию) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|authpassphrase|string|Фраза-пароль аутентификации SNMPv3. Используется только интерфейсами SNMPv3.|
|privpassphrase|string|Фраза-пароль конфиденциальности SNMPv3. Используется только интерфейсами SNMPv3.|
|authprotocol|integer|Протокол аутентификации SNMPv3. Используется только интерфейсами SNMPv3.<br><br>Возможные значения:<br>0 - (по умолчанию) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.|
|privprotocol|integer|Протокол конфиденциальности SNMPv3. Используется только интерфейсами SNMPv3.<br><br>Возможные значения:<br>0 - (по умолчанию) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.|
|contextname|string|Имя контекста SNMPv3. Используется только интерфейсами SNMPv3.|

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