[comment]: # translation:outdated

[comment]: # ({7ed888d2-7ed888d2})
# > Об'єкт інтерфейсу хоста

Наступні об’єкти безпосередньо пов’язані з API 'hostinterface'.

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

[comment]: # ({ac05f7e0-ce77a3b0})

### Інтерфейс хоста

Об'єкт інтерфейсу хоста має такі властивості.

::: noteimportant
Зауважте, що потрібні як IP, так і DNS. Якщо ви не хочете використовувати DNS, встановіть для нього порожній рядок.
:::

|Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис|
|--|--|------|
|available|integer|*(readonly)* Доступність інтерфейсу хоста.<br><br>Можливі значення:<br>0 - *(за замовчуванням)* невідомо;<br>1 - доступно;<br>2 - недоступно .|
|details|array|Додатковий об'єкт для інтерфейсу. **Обов’язково**, якщо «тип» інтерфейсу — SNMP.|
|disable\_until|timestamp|*(лише читання)* Час наступного опитування недоступного інтерфейсу хоста.|
|**dns**<br>(required)|string|Ім’я DNS, яке використовується інтерфейсом.<br><br>Може бути порожнім, якщо з’єднання здійснюється через IP.|
|error|string|*(readonly)* Текст помилки, якщо інтерфейс хоста недоступний.|
|errors\_from|timestamp|*(readonly)* Час, коли інтерфейс хоста став недоступним.|
|**hostid**<br>(required)|string|Ідентифікатор хоста, якому належить інтерфейс.|
|interfaceid|рядок|*(readonly)* ID інтерфейсу.|
|**ip**<br>(required)|string|IP-адреса, яка використовується інтерфейсом.<br><br>Може бути порожнім, якщо підключення здійснюється через DNS.|
|**main**<br>(обов'язково)|integer|Чи використовується інтерфейс за замовчуванням на хості. Лише один інтерфейс певного типу може бути встановлений за замовчуванням на хості.<br><br>Можливі значення:<br>0 - не за замовчуванням;<br>1 - за замовчуванням.|
|**порт**<br>(required)|string|Номер порту, який використовується інтерфейсом. Може містити макроси користувача.|
|**тип**<br>(required)|integer|Тип інтерфейсу.<br><br>Можливі значення:<br>1 - агент;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>|
|**useip**<br>(required)|integer|Чи має здійснюватися з’єднання через IP.<br><br>Можливі значення:<br>0 - підключитися за допомогою імені хоста DNS;<br>1 - підключитися за допомогою IP-адреси хоста для цього інтерфейсу хоста.|

Зауважте, що для деяких методів (оновлення, видалення) комбінація обов’язкових/необов’язкових параметрів відрізняється.

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

[comment]: # ({6024b51f-3bb71fcc})
### Тег деталей

Об'єкт деталей має такі властивості.

|Властивість|[Тип](/manual/api/reference_commentary#data_types)|Опис|
|--|--|------|
|**version**<br>(required)|integer|Версія інтерфейсу SNMP.<br><br>Можливі значення:<br>1 – SNMPv1;<br>2 – SNMPv2c;<br>3 – SNMPv3|
|bulk|integer|Чи використовувати масові запити SNMP.<br><br>Можливі значення:<br>0 - не використовувати масові запити;<br>1 - (за замовчуванням) - використовувати масові запити.|
|community|string|Спільнота SNMP (обов'язково). Використовується лише інтерфейсами SNMPv1 та SNMPv2.|
|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]: # ({/6024b51f-3bb71fcc})