Oggetto interfaccia dell'host

I seguenti oggetti sono direttamente correlati all'API hostinterface.

Interfaccia del host

L'oggetto dell'interfaccia del host ha le seguenti proprietà.

Proprietà Tipo Descrizione
interfaceid ID ID dell'interfaccia.

Comportamento della proprietà:
- sola lettura
- obbligatoria per le operazioni di aggiornamento
available integer Disponibilità dell'interfaccia del host.

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

Comportamento della proprietà:
- sola lettura
hostid ID ID del host a cui appartiene l'interfaccia.

Comportamento della proprietà:
- costante
- obbligatoria per le operazioni di creazione
type integer Tipo di interfaccia.

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

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
ip string Indirizzo IP utilizzato dall'interfaccia.

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

Comportamento della proprietà:
- obbligatorio per le operazioni di creazione
dns string Nome DNS utilizzato dall'interfaccia.

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

Comportamento della proprietà:
- obbligatorio per le operazioni di creazione
port string Numero di porta utilizzato dall'interfaccia.
Può contenere macro utente.

Comportamento della proprietà:
- obbligatorio per le operazioni di creazione
useip integer Indica se la connessione deve essere effettuata tramite IP.

Valori possibili:
0 - connessione tramite il nome DNS del host;
1 - connessione tramite l'indirizzo IP del host.

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
main integer Indica se l'interfaccia viene utilizzata come predefinita sul host. Su un host è possibile impostare come predefinita una sola interfaccia di ciascun tipo.

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

Comportamento della proprietà:
- obbligatoria per le operazioni di creazione
details object Oggetto details aggiuntivo per l'interfaccia.

Comportamento della proprietà:
- obbligatorio se type è impostato su "SNMP"
disable_until timestamp Orario del prossimo polling di un'interfaccia del host non disponibile.

Comportamento della proprietà:
- sola lettura
error string Testo dell'errore se l'interfaccia del host non è disponibile.

Comportamento della proprietà:
- sola lettura
errors_from timestamp Orario in cui l'interfaccia del host è diventata non disponibile.

Comportamento della proprietà:
- 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.