[comment]: # translation:outdated

[comment]: # ({7ed888d2-7ed888d2})
# > Hostinterface-object

De volgende objecten zijn direct gerelateerd aan de `hostinterface` API.

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

[comment]: # ({bc413b9e-ce77a3b0})
### Hostinterface

Het hostinterface-object heeft de volgende eigenschappen.

::: noteimportant
Merk op dat zowel de eigenschappen `ip` als `dns` *verplicht* zijn voor maakbewerkingen.
Als je DNS niet wilt gebruiken, stel het dan in op een lege string.
:::

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|interfaceid|string|ID van het interface.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen lezen*<br>- *verplicht* voor bijgewerkte bewerkingen|
|available|integer|Beschikbaarheid van hostinterface.<br><br>Mogelijke waarden:<br>0 - *(standaard)* onbekend;<br>1 - beschikbaar;<br>2 - niet beschikbaar.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen lezen*|
|hostid|string|ID van de host waar het interface bij hoort.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *verplicht* voor maakbewerkingen|
|type|integer|Type interface.<br><br>Mogelijke waarden:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* voor maakbewerkingen|
|ip|string|IP-adres dat door het interface wordt gebruikt.<br><br>Kan leeg zijn als de verbinding via DNS wordt gemaakt.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* voor maakbewerkingen|
|dns|string|DNS-naam die door het interface wordt gebruikt.<br><br>Kan leeg zijn als de verbinding via IP wordt gemaakt.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* voor maakbewerkingen|
|port|string|Poortnummer dat door het interface wordt gebruikt.<br>Kan gebruikersmacro's bevatten.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* voor maakbewerkingen|
|useip|integer|Of de verbinding via IP moet worden gemaakt.<br><br>Mogelijke waarden:<br>0 - verbinding maken via host DNS-naam;<br>1 - verbinding maken via host IP-adres.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* voor maakbewerkingen|
|main|integer|Of het interface als standaard wordt gebruikt op de host. Slechts één interface van een bepaald type kan als standaard worden ingesteld op een host.<br><br>Mogelijke waarden:<br>0 - niet standaard;<br>1 - standaard.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* voor maakbewerkingen|
|details|array|Extra [details](#details) object voor interface.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* indien `type` is ingesteld op "SNMP"|
|disable\_until|timestamp|De volgende pollingtijd van een niet-beschikbaar hostinterface.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen lezen*|
|error|string|Fouttekst als hostinterface niet beschikbaar is.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen lezen*|
|errors\_from|timestamp|Tijd waarop hostinterface niet beschikbaar werd.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *alleen lezen*|

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

[comment]: # ({2a505928-3bb71fcc})
### Details

Het detail-object heeft de volgende eigenschappen.

|Eigenschap|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|version|integer|SNMP-interfaceversie.<br><br>Mogelijke waarden:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht*|
|bulk|integer|Of bulk SNMP-verzoeken moeten worden gebruikt.<br><br>Mogelijke waarden:<br>0 - geen bulkverzoeken gebruiken;<br>1 - (standaard) - bulkverzoeken gebruiken.|
|community|string|SNMP-community. Alleen gebruikt door SNMPv1- en SNMPv2-interfaces.<br><br>[Eigenschapsgedrag](/manual/api/reference_commentary#property-behavior):<br>- *verplicht* indien `version` is ingesteld op "SNMPv1" of "SNMPv2c"|
|max_repetitions|integer|Maximale herhaling waarde voor [native SNMP-bulkverzoeken](#native-snmp-bulk-verzoeken) (GetBulkRequest-PDU's).<br>Alleen gebruikt voor `discovery[]` en `walk[]` items in SNMPv2 en v3.<br><br>Standaard: 10.|
|securityname|string|SNMPv3-beveiligingsnaam. Alleen gebruikt door SNMPv3-interfaces.|
|securitylevel|integer|SNMPv3-beveiligingsniveau. Alleen gebruikt door SNMPv3-interfaces.<br><br>Mogelijke waarden:<br>0 - (standaard) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|authpassphrase|string|SNMPv3-authenticatiewachtwoord. Alleen gebruikt door SNMPv3-interfaces.|
|privpassphrase|string|SNMPv3-privacywachtwoord. Alleen gebruikt door SNMPv3-interfaces.|
|authprotocol|integer|SNMPv3-authenticatieprotocol. Alleen gebruikt door SNMPv3-interfaces.<br><br>Mogelijke waarden:<br>0 - (standaard) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.|
|privprotocol|integer|SNMPv3-privacyprotocol. Alleen gebruikt door SNMPv3-interfaces.<br><br>Mogelijke waarden:<br>0 - (standaard) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.|
|contextname|string|SNMPv3-contextnaam. Alleen gebruikt door SNMPv3-interfaces.|

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