> Host prototype object

De volgende objecten zijn direct gerelateerd aan de hostprototype API.

Host prototype

Het hostprototype-object heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
hostid string (alleen lezen) ID van het hostprototype.
host
(vereist)
string Technische naam van het hostprototype.
name string Zichtbare naam van het hostprototype.

Standaard: waarde van de host-eigenschap.
status integer Status van het hostprototype.

Mogelijke waarden zijn:
0 - (standaard) bewaakte host;
1 - niet-bewaakte host.
inventory_mode integer Host inventarisatie modus.

Mogelijke waarden zijn:
-1 - (standaard) uitgeschakeld;
0 - handmatig;
1 - automatisch.
templateid string (alleen lezen) ID van het ouder sjabloon hostprototype.
discover integer Status van hostprototype-ontdekking.

Mogelijke waarden:
0 - (standaard) nieuwe hosts worden ontdekt;
1 - nieuwe hosts worden niet ontdekt en bestaande hosts worden gemarkeerd als verloren.
custom_interfaces integer Bron van interfaces voor hosts gemaakt door het hostprototype.

Mogelijke waarden:
0 - (standaard) overneem interfaces van ouder host;
1 - gebruik aangepaste interfaces van hostprototypes.
uuid string Unieke universele identifier, gebruikt om geïmporteerde hostprototypen te koppelen aan reeds bestaande exemplaren. Alleen gebruikt voor hostprototypen op sjablonen. Wordt automatisch gegenereerd als niet opgegeven.

Let op dat voor sommige methoden (update, delete) de vereiste/optionele parametercombinatie anders kan zijn.

Het groepskoppelingsobject koppelt een hostprototype aan een hostgroep en heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
groupid
(vereist)
string ID van de hostgroep.

Groep prototype

Het groep-prototype-object definieert een groep die zal worden gemaakt voor een ontdekte host en heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
name
(vereist)
string Naam van het groep-prototype.

Host prototype tag

Het hostprototype-tagobject heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
tag
(vereist)
string Tagnaam hostprototype.
value string Prototype-tagwaarde hosten.

Aangepaste interface

Het aangepaste interface-object heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
dns string DNS-naam die wordt gebruikt door de interface.

Vereist als de verbinding via DNS wordt gemaakt. Kan macro's bevatten.
ip string IP-adres gebruikt door de interface.

Vereist als de verbinding via IP wordt gemaakt. Kan macro's bevatten.
main
(vereist)
geheel getal Of de interface standaard wordt gebruikt op de host. Er kan slechts één interface van een bepaald type als standaard worden ingesteld op een host.

Mogelijke waarden zijn:
0 - niet standaard;
1 - standaard.
poort
(verplicht)
string Poortnummer gebruikt door de interface. Kan gebruikers- en LLD-macro's bevatten.
type
(vereist)
geheel getal Interface type.

Mogelijke waarden zijn:
1 - agent;
2 - SNMP;
3 - IPMI;< br>4 - JMX.
useip
(vereist)
geheel getal Of de verbinding moet worden gemaakt via IP.

Mogelijke waarden zijn:
0 - verbinding maken met host-DNS-naam;
1 - maak verbinding met het host-IP-adres voor deze hostinterface.
details array Extra object voor interface. Vereist als interface 'type' SNMP is.

Aangepaste interface details

Het detailobject heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
versie
(vereist)
geheel getal SNMP-interfaceversie.

Mogelijke waarden zijn:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk geheel getal Of bulk-SNMP-verzoeken moeten worden gebruikt.

Mogelijke waarden zijn:
0 - gebruik geen bulkverzoeken;
1 - (standaard) - gebruik bulkverzoeken.
community string SNMP-community. Alleen gebruikt door SNMPv1- en SNMPv2-interfaces.
securityname string SNMPv3-beveiligingsnaam. Alleen gebruikt door SNMPv3-interfaces.
beveiligingsniveau geheel getal SNMPv3-beveiligingsniveau. Alleen gebruikt door SNMPv3-interfaces.

Mogelijke waarden zijn:
0 - (standaard) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string SNMPv3-wachtwoordzin voor authenticatie. Alleen gebruikt door SNMPv3-interfaces.
privpassphrase string SNMPv3 privacywachtwoord. Alleen gebruikt door SNMPv3-interfaces.
authprotocol integer SNMPv3-verificatieprotocol. Alleen gebruikt door SNMPv3-interfaces.

Mogelijke waarden zijn:
0 - (standaard) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer SNMPv3-privacyprotocol. Alleen gebruikt door SNMPv3-interfaces.

Mogelijke waarden zijn:
0 - (standaard) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string SNMPv3-contextnaam. Alleen gebruikt door SNMPv3-interfaces.