Host-Interface-Objekt

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

Host-Schnittstelle

Das Host-Schnittstellenobjekt verfügt über die folgenden Eigenschaften.

Property Type Description
interfaceid ID ID der Schnittstelle.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsvorgänge
available integer Verfügbarkeit der Host-Schnittstelle.

Mögliche Werte:
0 - (Standard) unbekannt;
1 - verfügbar;
2 - nicht verfügbar.

Verhalten der Eigenschaft:
- schreibgeschützt
hostid ID ID des Hosts, zu dem die Schnittstelle gehört.

Verhalten der Eigenschaft:
- konstant
- erforderlich für Erstellungsvorgänge
type integer Schnittstellentyp.

Mögliche Werte:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
ip string Von der Schnittstelle verwendete IP-Adresse.

Kann leer sein, wenn die Verbindung über DNS hergestellt wird.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
dns string Von der Schnittstelle verwendeter DNS-Name.

Kann leer sein, wenn die Verbindung über IP hergestellt wird.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
port string Von der Schnittstelle verwendete Portnummer.
Kann Benutzermakros enthalten.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
useip integer Gibt an, ob die Verbindung über IP hergestellt werden soll.

Mögliche Werte:
0 - Verbindung über den DNS-Namen des Hosts herstellen;
1 - Verbindung über die IP-Adresse des Hosts herstellen.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
main integer Gibt an, ob die Schnittstelle als Standardschnittstelle auf dem Host verwendet wird. Pro Typ kann auf einem Host nur eine Schnittstelle als Standardschnittstelle festgelegt werden.

Mögliche Werte:
0 - nicht Standard;
1 - Standard.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsvorgänge
details object Zusätzliches Details-Objekt für die Schnittstelle.

Verhalten der Eigenschaft:
- erforderlich, wenn type auf "SNMP" gesetzt ist
disable_until timestamp Der nächste Abfragezeitpunkt einer nicht verfügbaren Host-Schnittstelle.

Verhalten der Eigenschaft:
- schreibgeschützt
error string Fehlertext, wenn die Host-Schnittstelle nicht verfügbar ist.

Verhalten der Eigenschaft:
- schreibgeschützt
errors_from timestamp Zeitpunkt, zu dem die Host-Schnittstelle nicht verfügbar wurde.

Verhalten der Eigenschaft:
- schreibgeschützt

Details

Das Objekt details hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
version integer Version der SNMP-Schnittstelle.

Mögliche Werte:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Verhalten der Eigenschaft:
- erforderlich
bulk integer Gibt an, ob Bulk-SNMP-Anfragen verwendet werden sollen.

Mögliche Werte:
0 - keine Bulk-Anfragen verwenden;
1 - (Standard) - Bulk-Anfragen verwenden.
community string SNMP-Community. Wird nur von SNMPv1- und SNMPv2-Schnittstellen verwendet.

Verhalten der Eigenschaft:
- erforderlich, wenn version auf "SNMPv1" oder "SNMPv2c" gesetzt ist
max_repetitions integer Maximaler Wiederholungswert für native SNMP-Bulk-Anfragen (GetBulkRequest-PDUs).
Wird nur für discovery[]- und walk[]-Datenpunkte in SNMPv2 und v3 verwendet.

Standard: 10.
securityname string SNMPv3-Sicherheitsname. Wird nur von SNMPv3-Schnittstellen verwendet.
securitylevel integer SNMPv3-Sicherheitsstufe. Wird nur von SNMPv3-Schnittstellen verwendet.

Mögliche Werte:
0 - (Standard) - noAuthNoPriv;
1 - authNoPriv;
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.

Mögliche Werte:
0 - (Standard) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer SNMPv3-Datenschutzsprotokoll. Wird nur von SNMPv3-Schnittstellen verwendet.

Mögliche Werte:
0 - (Standard) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string SNMPv3-Kontextname. Wird nur von SNMPv3-Schnittstellen verwendet.