Host-Prototyp-Objekt

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

Host-Prototyp

Das Host-Prototyp-Objekt hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
hostid ID ID des Host-Prototyps.

Property behavior:
- read-only
- required für Aktualisierungsvorgänge
host string Technischer Name des Host-Prototyps.

Property behavior:
- required für Erstellungsvorgänge
- read-only für vererbte Objekte
name string Sichtbarer Name des Host-Prototyps.

Standard: Wert der Eigenschaft host.

Property behavior:
- read-only für vererbte Objekte
status integer Status des Host-Prototyps.

Mögliche Werte:
0 - (Standard) überwachter Host;
1 - nicht überwachter Host.
flags integer Herkunft des Host-Prototyps.

Mögliche Werte:
2 - ein Host-Prototyp;
6 - ein entdeckter Host-Prototyp

Property behavior:
- read-only
inventory_mode integer Modus zum Befüllen des Host-Inventars.

Mögliche Werte:
-1 - (Standard) deaktiviert;
0 - manuell;
1 - automatisch.
templateid ID ID des übergeordneten Vorlagen-Host-Prototyps.

Property behavior:
- read-only
discover integer Erkennungsstatus des Host-Prototyps.

Mögliche Werte:
0 - (Standard) neue Hosts werden erkannt;
1 - neue Hosts werden nicht erkannt und vorhandene Hosts werden als verloren markiert.
custom_interfaces integer Quelle der benutzerdefinierten Schnittstellen für Hosts, die durch den Host-Prototyp erstellt werden.

Mögliche Werte:
0 - (Standard) Schnittstellen vom übergeordneten Host erben;
1 - benutzerdefinierte Schnittstellen des Host-Prototyps verwenden.

Property behavior:
- read-only für vererbte Objekte
uuid string Universell eindeutige Kennung, die verwendet wird, um importierte Host-Prototypen mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn sie nicht angegeben ist.

Property behavior:
- supported wenn der Host-Prototyp zu einer Vorlage gehört

Gruppenverknüpfung

Das Objekt „Gruppenverknüpfung“ verknüpft einen Host-Prototyp mit einer Host-Gruppe. Es hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
groupid ID ID der Host-Gruppe.

Verhalten der Eigenschaft:
- erforderlich

Gruppenprototyp

Das Gruppenprototyp-Objekt definiert eine Gruppe, die für einen erkannten Host erstellt wird. Es hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
group_prototypeid ID ID des Gruppenprototyps.

Verhalten der Eigenschaft:
- schreibgeschützt
name string Name des Gruppenprototyps.

Verhalten der Eigenschaft:
- erforderlich für Erstellungsoperationen

Tag des Host-Prototyps

Das Tag-Objekt des Host-Prototyps hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
tag string Name des Tags des Host-Prototyps.

Property behavior:
- required
value string Wert des Tags des Host-Prototyps.

Property behavior:
- read-only.
object integer Typ des Objekts, von dem das Tag geerbt wurde.

Mögliche Werte:
0 - Vorlage.

Property behavior:
- read-only.
objectid ID ID des Objekts, von dem das Tag geerbt wurde.

Property behavior:
- read-only.

Benutzerdefinierte Schnittstelle

Benutzerdefinierte Schnittstellen werden unterstützt, wenn custom_interfaces des Host prototype object auf „benutzerdefinierte Schnittstellen von Host-Prototypen verwenden“ gesetzt ist. Das Objekt für benutzerdefinierte Schnittstellen hat die folgenden Eigenschaften.

Eigenschaft Type Beschreibung
type integer Schnittstellentyp.

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

Property behavior:
- erforderlich
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.

Property behavior:
- erforderlich
ip string Von der Schnittstelle verwendete IP-Adresse.
Kann Makros enthalten.

Property behavior:
- erforderlich, wenn useip auf „Verbindung über die IP-Adresse des Hosts herstellen“ gesetzt ist
dns string Von der Schnittstelle verwendeter DNS-Name.
Kann Makros enthalten.

Property behavior:
- erforderlich, wenn useip auf „Verbindung über den DNS-Namen des Hosts herstellen“ gesetzt ist
port string Von der Schnittstelle verwendete Portnummer.
Kann Benutzer- und LLD-Makros enthalten.

Property behavior:
- erforderlich
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.

Property behavior:
- erforderlich
details object Zusätzliches Objekt für Details benutzerdefinierter Schnittstellen.

Property behavior:
- erforderlich, wenn type auf „SNMP“ gesetzt ist

Details der benutzerdefinierten Schnittstelle

Das Detailobjekt hat die folgenden Eigenschaften.

Eigenschaft Typ Beschreibung
version integer Version der SNMP-Schnittstelle.

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

Eigenschaftsverhalten:
- 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.

Eigenschaftsverhalten:
- 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.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" gesetzt ist
securitylevel integer SNMPv3-Sicherheitsstufe.

Mögliche Werte:
0 - (Standard) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" gesetzt ist
authpassphrase string SNMPv3-Authentifizierungs-Passphrase.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" und securitylevel auf "authNoPriv" oder "authPriv" gesetzt ist
privpassphrase string SNMPv3-Datenschutz-Passphrase.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" und securitylevel auf "authPriv" gesetzt ist
authprotocol integer SNMPv3-Authentifizierungsprotokoll.

Mögliche Werte:
0 - (Standard) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" und securitylevel auf "authNoPriv" oder "authPriv" gesetzt ist
privprotocol integer SNMPv3-Datenschutzprotokoll. Wird nur von SNMPv3-Schnittstellen verwendet.

Mögliche Werte:
0 - (Standard) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" und securitylevel auf "authPriv" gesetzt ist
contextname string SNMPv3-Kontextname.

Eigenschaftsverhalten:
- unterstützt, wenn version auf "SNMPv3" gesetzt ist