[comment]: # translation:outdated

[comment]: # aside:1

[comment]: # ({94e18e5a-7ed888d2})
# Obiekt interfejsu hosta

Następujące obiekty są bezpośrednio powiązane z API `hostinterface`.

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

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

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

::: noteimportant
Należy pamiętać, że zarówno właściwości `ip`, jak i `dns` są *wymagane* dla operacji tworzenia.
Jeśli nie chcesz używać DNS, ustaw go jako pusty ciąg znaków.
:::

|Właściwość|[Type](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|interfaceid|ID|ID interfejsu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|available|integer|Dostępność interfejsu hosta.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* nieznana;<br>1 - dostępny;<br>2 - niedostępny.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|hostid|ID|ID hosta, do którego należy interfejs.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *stała*<br>- *wymagane* dla operacji tworzenia|
|type|integer|Typ interfejsu.<br><br>Możliwe wartości:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|ip|string|Adres IP używany przez interfejs.<br><br>Może być pusty, jeśli połączenie jest nawiązywane przez DNS.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|dns|string|Nazwa DNS używana przez interfejs.<br><br>Może być pusta, jeśli połączenie jest nawiązywane przez IP.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|port|string|Numer portu używany przez interfejs.<br>Może zawierać makra użytkownika.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|useip|integer|Czy połączenie powinno być nawiązywane przez IP.<br><br>Możliwe wartości:<br>0 - połącz przy użyciu nazwy DNS hosta;<br>1 - połącz przy użyciu adresu IP hosta.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|main|integer|Czy interfejs jest używany jako domyślny na hoście. Tylko jeden interfejs danego typu może być ustawiony jako domyślny na hoście.<br><br>Możliwe wartości:<br>0 - nie jest domyślny;<br>1 - domyślny.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|details|object|Dodatkowy obiekt [details](#details) dla interfejsu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli `type` jest ustawione na "SNMP"|
|disable\_until|timestamp|Czas następnego odpytywania niedostępnego interfejsu hosta.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|error|string|Tekst błędu, jeśli interfejs hosta jest niedostępny.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|errors\_from|timestamp|Czas, kiedy interfejs hosta stał się niedostępny.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|

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

[comment]: # ({58c84008-3bb71fcc})
#### Szczegóły

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

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|version|integer|Wersja interfejsu SNMP.<br><br>Możliwe wartości:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|bulk|integer|Czy używać zbiorczych żądań SNMP.<br><br>Możliwe wartości:<br>0 - nie używaj zbiorczych żądań;<br>1 - (domyślnie) - używaj zbiorczych żądań.|
|community|string|Społeczność SNMP. Używana tylko przez interfejsy SNMPv1 i SNMPv2.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* jeśli `version` jest ustawione na "SNMPv1" lub "SNMPv2c"|
|max_repetitions|integer|Maksymalna wartość powtórzeń dla [natywnych zbiorczych żądań SNMP](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Używane tylko dla pozycji `discovery[]` i `walk[]` w SNMPv2 i v3.<br><br>Domyślnie: 10.|
|securityname|string|Nazwa bezpieczeństwa SNMPv3. Używana tylko przez interfejsy SNMPv3.|
|securitylevel|integer|Poziom bezpieczeństwa SNMPv3. Używany tylko przez interfejsy SNMPv3.<br><br>Możliwe wartości:<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żywany tylko przez interfejsy SNMPv3.<br><br>Możliwe wartości:<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żywany tylko przez interfejsy SNMPv3.<br><br>Możliwe wartości:<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żywana tylko przez interfejsy SNMPv3.|

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