[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({94e18e5a-7ed888d2})
# Oggetto interfaccia dell'host

I seguenti oggetti sono direttamente correlati all'API `hostinterface`.

[comment]: # ({/94e18e5a-7ed888d2})

[comment]: # ({2e033569-ce77a3b0})
### Interfaccia host

L'oggetto interfaccia host ha le seguenti proprietà.

::: noteimportant
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](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|interfaceid|ID|ID dell'interfaccia.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*<br>- *obbligatoria* per le operazioni di aggiornamento|
|available|integer|Disponibilità dell'interfaccia host.<br><br>Valori possibili:<br>0 - *(predefinito)* sconosciuta;<br>1 - disponibile;<br>2 - non disponibile.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|hostid|ID|ID dell'host a cui appartiene l'interfaccia.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *costante*<br>- *obbligatoria* per le operazioni di creazione|
|type|integer|Tipo di interfaccia.<br><br>Valori possibili:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|ip|string|Indirizzo IP utilizzato dall'interfaccia.<br><br>Può essere vuoto se la connessione viene effettuata tramite DNS.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|dns|string|Nome DNS utilizzato dall'interfaccia.<br><br>Può essere vuoto se la connessione viene effettuata tramite IP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|port|string|Numero di porta utilizzato dall'interfaccia.<br>Può contenere macro utente.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|useip|integer|Indica se la connessione deve essere effettuata tramite IP.<br><br>Valori possibili:<br>0 - connetti utilizzando il nome DNS dell'host;<br>1 - connetti utilizzando l'indirizzo IP dell'host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *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.<br><br>Valori possibili:<br>0 - non predefinita;<br>1 - predefinita.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* per le operazioni di creazione|
|details|object|Oggetto [details](#details) aggiuntivo per l'interfaccia.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *obbligatorio* se `type` è impostato su "SNMP"|
|disable\_until|timestamp|Ora del prossimo polling di un'interfaccia host non disponibile.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|error|string|Testo dell'errore se l'interfaccia host non è disponibile.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|
|errors\_from|timestamp|Ora in cui l'interfaccia host è diventata non disponibile.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *sola lettura*|

[comment]: # ({/2e033569-ce77a3b0})

[comment]: # ({58c84008-3bb71fcc})
#### Dettagli

L'oggetto details ha le seguenti proprietà.

|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|version|integer|Versione dell'interfaccia SNMP.<br><br>Valori possibili:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria*|
|bulk|integer|Indica se utilizzare richieste SNMP bulk.<br><br>Valori possibili:<br>0 - non utilizzare richieste bulk;<br>1 - (predefinito) - utilizzare richieste bulk.|
|community|string|Community SNMP. Utilizzata solo dalle interfacce SNMPv1 e SNMPv2.<br><br>[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):<br>- *obbligatoria* se `version` è impostato su "SNMPv1" o "SNMPv2c"|
|max_repetitions|integer|Valore massimo di ripetizione per le [richieste SNMP bulk native](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Utilizzato solo per gli item `discovery[]` e `walk[]` in SNMPv2 e v3.<br><br>Predefinito: 10.|
|securityname|string|Nome di sicurezza SNMPv3. Utilizzato solo dalle interfacce SNMPv3.|
|securitylevel|integer|Livello di sicurezza SNMPv3. Utilizzato solo dalle interfacce SNMPv3.<br><br>Valori possibili:<br>0 - (predefinito) - noAuthNoPriv;<br>1 - authNoPriv;<br>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.<br><br>Valori possibili:<br>0 - (predefinito) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.|
|privprotocol|integer|Protocollo di privacy SNMPv3. Utilizzato solo dalle interfacce SNMPv3.<br><br>Valori possibili:<br>0 - (predefinito) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.|
|contextname|string|Nome del contesto SNMPv3. Utilizzato solo dalle interfacce SNMPv3.|

[comment]: # ({/58c84008-3bb71fcc})