Host-Interface-Objekt

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

Host-Schnittstelle

Das Objekt der Host-Schnittstelle hat die folgenden Eigenschaften.

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 Beschreibung
interfaceid ID ID der Schnittstelle.

Verhalten der Eigenschaft:
- schreibgeschützt
- erforderlich für Aktualisierungsoperationen
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 Erstellungsoperationen
type integer Schnittstellentyp.

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

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

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

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

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

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

Verhalten der Eigenschaft:
- erforderlich für Erstellungsoperationen
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 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.

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

Verhalten der Eigenschaft:
- erforderlich für Erstellungsoperationen
details object Zusätzliches Objekt mit Details 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.