Oggetto prototipo di host

I seguenti oggetti sono direttamente correlati all'API hostprototype.

Host prototype

L'oggetto host prototype ha le seguenti proprietà.

Property Type Description
hostid ID ID dell'host prototype.

Property behavior:
- read-only
- required for update operations
host string Nome tecnico dell'host prototype.

Property behavior:
- required for create operations
- read-only for inherited objects
name string Nome visibile dell'host prototype.

Default: valore della proprietà host.

Property behavior:
- read-only for inherited objects
status integer Stato dell'host prototype.

Possible values:
0 - (default) monitored host;
1 - unmonitored host.
inventory_mode integer Modalità di popolamento dell'inventario dell'host.

Possible values:
-1 - (default) disabled;
0 - manual;
1 - automatic.
templateid ID ID dell'host prototype del template padre.

Property behavior:
- read-only
discover integer Stato di discovery dell'host prototype.

Possible values:
0 - (default) new hosts will be discovered;
1 - new hosts will not be discovered and existing hosts will be marked as lost.
custom_interfaces integer Origine delle custom interfaces per gli host creati dall'host prototype.

Possible values:
0 - (default) inherit interfaces from parent host;
1 - use host prototypes custom interfaces.

Property behavior:
- read-only for inherited objects
uuid string Identificatore univoco universale, usato per collegare gli host prototype importati a quelli già esistenti. Generato automaticamente, se non specificato.

Property behavior:
- supported if the host prototype belongs to a 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 prototype di host

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

Property Type Description
tag string Nome del tag del prototype di host.

Property behavior:
- required
value string Valore del tag del prototype di host.

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"