[comment]: # translation:outdated

[comment]: # ({7ed888d2-7ed888d2})
# > Obiekt Host interface

Poniższe obiekty są bezpośrednio związane z interfejsem API `hostinterface`.

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

[comment]: # ({406853c6-ce77a3b0})
### Host interface

Obiekt Host interface ma następujące właściwości.

::: noteimportant
Zwróć uwagę, że zarówno adres IP, jak i DNS są wymagane. Jeśli 
nie chcesz używać DNS, ustaw go jako pusty ciąg znaków.
:::

|Właściwość|[Typ](/manual/api/reference_commentary#data_types)|Opis|
|--|--|------|
|available|integer|*(tylko do odczytu)* Dostępność interfejsu hosta.<br><br>Możliwe wartości to:<br>0 - *(domyślnie)* nieznany;<br>1 - dostępny;<br>2 - niedostępny.|
|details|array|Dodatkowy obiekt interfejsu. **Wymagane** jeśli typ interfejsu to SNMP.|
|disable\_until|timestamp|*(tylko do odczytu)* Czas następnego odpytywania niedostępnego interfejsu hosta.|
|**dns**<br>(wymagane)|string|Nazwa DNS używana przez interfejs.<br><br>Może być pusty, jeśli połączenie jest realizowane za pomocą adresu IP.|
|error|string|*(tylko do odczytu)* Tekst błędu, jeśli interfejs hosta jest niedostępny.|
|errors\_from|timestamp|*(tylko do odczytu)* Czas, kiedy interfejs hosta stał się niedostępny.|
|**hostid**<br>(wymagane)|string|ID hosta, do którego należy interfejs.|
|interfaceid|string|*(tylko do odczytu)* ID interfejsu.|
|**ip**<br>(wymagane)|string|Adres IP używany przez interfejs.<br><br>Może być pusty, jeśli połączenie jest realizowane za pomocą DNS.|
|**main**<br>(wymagane)|integer|Czy interfejs jest używany jako domyślny na hoście. Tylko jeden interfejs tego samego typu może być ustawiony jako domyślny na hoście.<br><br>Możliwe wartości to:<br>0 - nie domyślny;<br>1 - domyślny.|
|**port**<br>(wymagane)|string|Numer portu używany przez interfejs. Może zawierać makra użytkownika.|
|**type**<br>(wymagane)|integer|Typ interfejsu.<br><br>Możliwe wartości to:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>|
|**useip**<br>(wymagane)|integer|Czy połączenie powinno być realizowane za pomocą adresu IP.<br><br>Możliwe wartości to:<br>0 - połącz używając nazwy DNS hosta;<br>1 - połącz używając adresu IP hosta dla tego interfejsu hosta.|

Zauważ, że dla niektórych metod (update, delete) kombinacja parametrów wymaganych/opcjonalnych może być inna.

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

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

Obiekt details ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data_types)|Opis|
|--|--|------|
|**version**<br>(wymagane)|integer|Wersja interfejsu SNMP.<br><br>Możliwe wartości to:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3|
|bulk|integer|Czy używać łączonych żądań SNMP.<br><br>Możliwe wartości to:<br>0 - nie używaj żądań łączonych;<br>1 - (domyślnie) - użyj żądań łączonych.|
|community|string|Hasło SNMP (wymagane). Używane tylko przez interfejsy SNMPv1 i SNMPv2.|
|securityname|string|Nazwa ochrony SNMPv3. Używane tylko przez interfejsy SNMPv3.|
|securitylevel|integer|Poziom zabezpieczeń SNMPv3. Używane tylko przez interfejsy SNMPv3.<br><br>Możliwe wartości to:<br>0 - (domyślnie) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|authpassphrase|string|Hasło uwierzytelniania SNMPv3. Używane tylko przez interfejsy SNMPv3.|
|privpassphrase|string|Hasło prywatności SNMPv3. Używane tylko przez interfejsy SNMPv3.|
|authprotocol|integer|Protokół uwierzytelniania SNMPv3. Używane tylko przez interfejsy SNMPv3.<br><br>Możliwe wartości to:<br>0 - (domyślnie) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.|
|privprotocol|integer|Protokół prywatności SNMPv3. Używane tylko przez interfejsy SNMPv3.<br><br>Możliwe wartości to:<br>0 - (domyślnie) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.|
|contextname|string|Nazwa kontekstu SNMPv3. Używane tylko przez interfejsy SNMPv3.|

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