[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({94e18e5a-7ed888d2})
# Host-Interface-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der `hostinterface` API.

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

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

Das Objekt der Host-Schnittstelle hat die folgenden Eigenschaften.

::: noteimportant
Beachten Sie, dass sowohl die Eigenschaften `ip` als auch `dns` für Erstellungsoperationen *erforderlich* sind.
Wenn Sie DNS nicht verwenden möchten, setzen Sie es auf eine leere Zeichenfolge.
:::

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|interfaceid|ID|ID der Schnittstelle.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *erforderlich* für Aktualisierungsoperationen|
|available|integer|Verfügbarkeit der Host-Schnittstelle.<br><br>Mögliche Werte:<br>0 - *(Standard)* unbekannt;<br>1 - verfügbar;<br>2 - nicht verfügbar.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|hostid|ID|ID des Hosts, zu dem die Schnittstelle gehört.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *konstant*<br>- *erforderlich* für Erstellungsoperationen|
|type|integer|Schnittstellentyp.<br><br>Mögliche Werte:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen|
|ip|string|Von der Schnittstelle verwendete IP-Adresse.<br><br>Kann leer sein, wenn die Verbindung über DNS hergestellt wird.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen|
|dns|string|Von der Schnittstelle verwendeter DNS-Name.<br><br>Kann leer sein, wenn die Verbindung über IP hergestellt wird.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen|
|port|string|Von der Schnittstelle verwendete Portnummer.<br>Kann Benutzermakros enthalten.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen|
|useip|integer|Gibt an, ob die Verbindung über IP hergestellt werden soll.<br><br>Mögliche Werte:<br>0 - Verbindung über den DNS-Namen des Hosts herstellen;<br>1 - Verbindung über die IP-Adresse des Hosts herstellen.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen|
|main|integer|Gibt an, ob die Schnittstelle auf dem Host als Standard verwendet wird. Nur eine Schnittstelle eines bestimmten Typs kann auf einem Host als Standard festgelegt werden.<br><br>Mögliche Werte:<br>0 - nicht Standard;<br>1 - Standard.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsoperationen|
|details|object|Zusätzliches Objekt mit [Details](#details) für die Schnittstelle.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `type` auf "SNMP" gesetzt ist|
|disable\_until|timestamp|Der nächste Abfragezeitpunkt einer nicht verfügbaren Host-Schnittstelle.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|error|string|Fehlertext, wenn die Host-Schnittstelle nicht verfügbar ist.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|errors\_from|timestamp|Zeitpunkt, zu dem die Host-Schnittstelle nicht verfügbar wurde.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|

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

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

Das Objekt `details` hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|version|integer|Version der SNMP-Schnittstelle.<br><br>Mögliche Werte:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|bulk|integer|Gibt an, ob Bulk-SNMP-Anfragen verwendet werden sollen.<br><br>Mögliche Werte:<br>0 - keine Bulk-Anfragen verwenden;<br>1 - (Standard) - Bulk-Anfragen verwenden.|
|community|string|SNMP-Community. Wird nur von SNMPv1- und SNMPv2-Schnittstellen verwendet.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `version` auf "SNMPv1" oder "SNMPv2c" gesetzt ist|
|max_repetitions|integer|Maximaler Wiederholungswert für [native SNMP-Bulk-Anfragen](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Wird nur für `discovery[]`- und `walk[]`-Datenpunkte in SNMPv2 und v3 verwendet.<br><br>Standard: 10.|
|securityname|string|SNMPv3-Sicherheitsname. Wird nur von SNMPv3-Schnittstellen verwendet.|
|securitylevel|integer|SNMPv3-Sicherheitsstufe. Wird nur von SNMPv3-Schnittstellen verwendet.<br><br>Mögliche Werte:<br>0 - (Standard) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|authpassphrase|string|SNMPv3-Authentifizierungs-Passphrase. Wird nur von SNMPv3-Schnittstellen verwendet.|
|privpassphrase|string|SNMPv3-Datenschutz-Passphrase. Wird nur von SNMPv3-Schnittstellen verwendet.|
|authprotocol|integer|SNMPv3-Authentifizierungsprotokoll. Wird nur von SNMPv3-Schnittstellen verwendet.<br><br>Mögliche Werte:<br>0 - (Standard) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.|
|privprotocol|integer|SNMPv3-Datenschutzsprotokoll. Wird nur von SNMPv3-Schnittstellen verwendet.<br><br>Mögliche Werte:<br>0 - (Standard) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.|
|contextname|string|SNMPv3-Kontextname. Wird nur von SNMPv3-Schnittstellen verwendet.|

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