Oggetto prototipo di host

I seguenti oggetti sono direttamente correlati all'API hostprototype.

Prototipo di host

L'oggetto prototipo di host ha le seguenti proprietà.

Property Type Description
hostid ID ID del prototipo di host.

Property behavior:
- sola lettura
- obbligatorio per le operazioni di aggiornamento
host string Nome tecnico del prototipo di host.

Property behavior:
- obbligatorio per le operazioni di creazione
- sola lettura per gli oggetti ereditati
name string Nome visibile del prototipo di host.

Predefinito: valore della proprietà host.

Property behavior:
- sola lettura per gli oggetti ereditati
status integer Stato del prototipo di host.

Valori possibili:
0 - (predefinito) host monitorato;
1 - host non monitorato.
flags integer Origine del prototipo di host.

Valori possibili:
2 - un prototipo di host;
6 - un prototipo di host individuato

Property behavior:
- sola lettura
inventory_mode integer Modalità di popolamento dell'inventario host.

Valori possibili:
-1 - (predefinito) disabilitato;
0 - manuale;
1 - automatico.
templateid ID ID del prototipo di host del template padre.

Property behavior:
- sola lettura
discover integer Stato di individuazione del prototipo di host.

Valori possibili:
0 - (predefinito) i nuovi host verranno individuati;
1 - i nuovi host non verranno individuati e gli host esistenti verranno contrassegnati come persi.
custom_interfaces integer Origine delle interfacce personalizzate per gli host creati dal prototipo di host.

Valori possibili:
0 - (predefinito) eredita le interfacce dall'host padre;
1 - usa le interfacce personalizzate dei prototipi di host.

Property behavior:
- sola lettura per gli oggetti ereditati
uuid string Identificatore univoco universale, utilizzato per collegare i prototipi di host importati a quelli già esistenti. Generato automaticamente, se non specificato.

Property behavior:
- supportato se il prototipo di host appartiene a un template

Collegamento del gruppo

L'oggetto collegamento del gruppo collega un prototipo di host con un gruppo di host. Ha le seguenti proprietà.

Proprietà Type Descrizione
groupid ID ID del gruppo di host.

Comportamento della proprietà:
- obbligatorio

Prototipo di gruppo

L'oggetto prototipo di gruppo definisce un gruppo che verrà creato per un host individuato. Ha le seguenti proprietà.

Proprietà Tipo Descrizione
group_prototypeid ID ID del prototipo di gruppo.

Comportamento della proprietà:
- sola lettura
name string Nome del prototipo di gruppo.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione

Tag del prototipo di host

L'oggetto tag del prototipo di host ha le seguenti proprietà.

Proprietà Type Descrizione
tag string Nome del tag del prototipo di host.

Comportamento della proprietà:
- obbligatoria
value string Valore del tag del prototipo di host.

Comportamento della proprietà:
- sola lettura.
object integer Tipo di oggetto da cui il tag è stato ereditato.

Valori possibili:
0 - template.

Comportamento della proprietà:
- sola lettura.
objectid ID ID dell'oggetto da cui il tag è stato ereditato.

Comportamento della proprietà:
- sola lettura.

Interfaccia personalizzata

Le interfacce personalizzate sono supportate se custom_interfaces dell'oggetto prototipo host è impostato su "usa le interfacce personalizzate dei prototipi host". L'oggetto interfaccia personalizzata ha le seguenti proprietà.

Proprietà Type Descrizione
type integer Tipo di interfaccia.

Valori possibili:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

Comportamento della proprietà:
- obbligatoria
useip integer Indica se la connessione deve essere effettuata tramite IP.

Valori possibili:
0 - connetti usando il nome DNS dell'host;
1 - connetti usando l'indirizzo IP dell'host.

Comportamento della proprietà:
- obbligatoria
ip string Indirizzo IP usato dall'interfaccia.
Può contenere macro.

Comportamento della proprietà:
- obbligatoria se useip è impostato su "connetti usando l'indirizzo IP dell'host"
dns string Nome DNS usato dall'interfaccia.
Può contenere macro.

Comportamento della proprietà:
- obbligatoria se useip è impostato su "connetti usando il nome DNS dell'host"
port string Numero di porta usato dall'interfaccia.
Può contenere macro utente e LLD.

Comportamento della proprietà:
- obbligatoria
main integer Indica se l'interfaccia è usata come predefinita sull'host.
Solo un'interfaccia di un determinato tipo può essere impostata come predefinita su un host.

Valori possibili:
0 - non predefinita;
1 - predefinita.

Comportamento della proprietà:
- obbligatoria
details object Oggetto aggiuntivo per i dettagli dell'interfaccia personalizzata.

Comportamento della proprietà:
- obbligatoria se type è impostato su "SNMP"

Dettagli dell'interfaccia personalizzata

L'oggetto details ha le seguenti proprietà.

Property Type Description
version integer Versione dell'interfaccia SNMP.

Valori possibili:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Comportamento della proprietà:
- obbligatoria
bulk integer Indica se utilizzare richieste SNMP bulk.

Valori possibili:
0 - non utilizzare richieste bulk;
1 - (predefinito) - utilizzare richieste bulk.
community string Community SNMP.

Comportamento della proprietà:
- obbligatoria se version è impostato su "SNMPv1" o "SNMPv2c"
max_repetitions integer Valore massimo di ripetizione per le richieste SNMP bulk native (GetBulkRequest-PDUs).
Utilizzato solo per gli item discovery[] e walk[] in SNMPv2 e v3.

Predefinito: 10.
securityname string Nome di sicurezza SNMPv3.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3"
securitylevel integer Livello di sicurezza SNMPv3.

Valori possibili:
0 - (predefinito) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3"
authpassphrase string Passphrase di autenticazione SNMPv3.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3" e securitylevel è impostato su "authNoPriv" o "authPriv"
privpassphrase string Passphrase di privacy SNMPv3.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3" e securitylevel è impostato su "authPriv"
authprotocol integer Protocollo di autenticazione SNMPv3.

Valori possibili:
0 - (predefinito) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3" e securitylevel è impostato su "authNoPriv" o "authPriv"
privprotocol integer Protocollo di privacy SNMPv3. Utilizzato solo dalle interfacce SNMPv3.

Valori possibili:
0 - (predefinito) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3" e securitylevel è impostato su "authPriv"
contextname string Nome del contesto SNMPv3.

Comportamento della proprietà:
- supportata se version è impostato su "SNMPv3"