Oggetto interfaccia dell'host

I seguenti oggetti sono direttamente correlati all'API hostinterface.

Interfaccia host

L'oggetto interfaccia host ha le seguenti proprietà.

Si noti che entrambe le proprietà ip e dns sono obbligatorie per le operazioni di creazione. Se non si desidera utilizzare DNS, impostarlo come stringa vuota.

Proprietà Type Descrizione
interfaceid ID ID dell'interfaccia.

Property behavior:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
available integer Disponibilità dell'interfaccia host.

Valori possibili:
0 - (predefinito) sconosciuta;
1 - disponibile;
2 - non disponibile.

Property behavior:
- sola lettura
hostid ID ID dell'host a cui appartiene l'interfaccia.

Property behavior:
- costante
- obbligatoria per le operazioni di creazione
type integer Tipo di interfaccia.

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

Property behavior:
- obbligatoria per le operazioni di creazione
ip string Indirizzo IP utilizzato dall'interfaccia.

Può essere vuoto se la connessione viene effettuata tramite DNS.

Property behavior:
- obbligatoria per le operazioni di creazione
dns string Nome DNS utilizzato dall'interfaccia.

Può essere vuoto se la connessione viene effettuata tramite IP.

Property behavior:
- obbligatoria per le operazioni di creazione
port string Numero di porta utilizzato dall'interfaccia.
Può contenere macro utente.

Property behavior:
- obbligatoria per le operazioni di creazione
useip integer Indica se la connessione deve essere effettuata tramite IP.

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

Property behavior:
- obbligatoria per le operazioni di creazione
main integer Indica se l'interfaccia viene utilizzata 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.

Property behavior:
- obbligatoria per le operazioni di creazione
details object Oggetto details aggiuntivo per l'interfaccia.

Property behavior:
- obbligatorio se type è impostato su "SNMP"
disable_until timestamp Ora del prossimo polling di un'interfaccia host non disponibile.

Property behavior:
- sola lettura
error string Testo dell'errore se l'interfaccia host non è disponibile.

Property behavior:
- sola lettura
errors_from timestamp Ora in cui l'interfaccia host è diventata non disponibile.

Property behavior:
- sola lettura

Dettagli

L'oggetto details ha le seguenti proprietà.

Proprietà Type Descrizione
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. Utilizzata solo dalle interfacce SNMPv1 e SNMPv2.

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. Utilizzato solo dalle interfacce SNMPv3.
securitylevel integer Livello di sicurezza SNMPv3. Utilizzato solo dalle interfacce SNMPv3.

Valori possibili:
0 - (predefinito) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Passphrase di autenticazione SNMPv3. Utilizzata solo dalle interfacce SNMPv3.
privpassphrase string Passphrase di privacy SNMPv3. Utilizzata solo dalle interfacce SNMPv3.
authprotocol integer Protocollo di autenticazione SNMPv3. Utilizzato solo dalle interfacce SNMPv3.

Valori possibili:
0 - (predefinito) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
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.
contextname string Nome del contesto SNMPv3. Utilizzato solo dalle interfacce SNMPv3.