[comment]: # translation:outdated
[comment]: # ({7ed888d2-7ed888d2})
# > Objeto de interfaz de host
Los siguientes objetos están directamente relacionados con la API `hostinterface`.
[comment]: # ({/7ed888d2-7ed888d2})
[comment]: # ({406853c6-ce77a3b0})
### Interfaz de host
El objeto de interfaz de host tiene las siguientes propiedades.
::: noteimportant
Tenga en cuenta que se requieren tanto IP como DNS.
Si no desea utilizar DNS, configúrelo en una cadena vacía.
:::
|Propiedad|[Tipo](/manual/api/reference_commentary#tipos_de_datos)|Descripción|
|--|--|------|
|disponible|número entero|*(sololectura)* Disponibilidad de la interfaz del host.
Los valores posibles son:
0 - *(predeterminado)* desconocido;
1 - disponible;
2 - no disponible .|
|detalles|matriz|Objeto adicional para interfaz. **Obligatorio** si el 'tipo' de interfaz es SNMP.|
|disable\_until|marca de tiempo|*(sololectura)* La próxima hora de sondeo de una interfaz de host no disponible.|
|**dns**
(obligatorio)|cadena|Nombre DNS utilizado por la interfaz.
Puede estar vacío si la conexión se realiza vía IP.|
|error|cadena|*(sololectura)* Texto de error si la interfaz del host no está disponible.|
|errors\_from|marca de tiempo|*(sololectura)* Hora en que la interfaz del host dejó de estar disponible.|
|**hostid**
(obligatorio)|cadena|ID del host al que pertenece la interfaz.|
|interfaceid|cadena|*(solo lectura)* ID de la interfaz.|
|**ip**
(obligatorio)|cadena|Dirección IP utilizada por la interfaz.
Puede estar vacía si la conexión se realiza mediante DNS.|
|**main**
(obligatorio)|número entero|Si la interfaz se utiliza de forma predeterminada en el host. Sólo se puede configurar una interfaz de algún tipo como predeterminada en un host.
Los valores posibles son:
0 - no predeterminado;
1 - predeterminado.|
|**puerto**
(obligatorio)|cadena|Número de puerto utilizado por la interfaz. Puede contener macros de usuario.|
|**tipo**
(obligatorio)|número entero|Tipo de interfaz.
Los valores posibles son:
1 - agente;
2 - SNMP;
3 - IPMI;< br>4 - JMX.
|
|**useip**
(obligatorio)|número entero|Si la conexión debe realizarse a través de IP o no.
Los valores posibles son:
0 - conectarse usando el nombre DNS del host;
1 - conéctese utilizando la dirección IP del host para esta interfaz de host.|
Tenga en cuenta que para algunos métodos (actualizar, eliminar) la combinación de parámetros requeridos/opcionales es diferente.
[comment]: # ({/406853c6-ce77a3b0})
[comment]: # ({8d373e4f-3bb71fcc})
### Etiqueta de detalles
El objeto de detalles tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#tipos_de_datos)|Descripción|
|--|--|------|
|**versión**
(obligatorio)|número entero|Versión de la interfaz SNMP.
Los valores posibles son:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3|
|bulk|número entero|Si se deben o no usar solicitudes SNMP masivas.
Los valores posibles son:
0 - no usar solicitudes masivas;
1 - (predeterminado) - usar solicitudes masivas.|
|comunidad|cadena|Comunidad SNMP (obligatoria). Utilizado únicamente por interfaces SNMPv1 y SNMPv2.|
|nombredeseguridad|cadena|nombre de seguridad SNMPv3. Utilizado únicamente por interfaces SNMPv3.|
|niveldeseguridad|número entero|Nivel de seguridad SNMPv3. Utilizado solo por interfaces SNMPv3.
Los valores posibles son:
0 - (predeterminado) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.|
|authpassphrase|cadena|frase de contraseña de autenticación SNMPv3. Utilizado únicamente por interfaces SNMPv3.|
|frasedecontraseñaprivada|cadena|frase de contraseña de privacidad SNMPv3. Utilizado únicamente por interfaces SNMPv3.|
|authprotocol|entero|Protocolo de autenticación SNMPv3. Utilizado solo por interfaces SNMPv3.
Los valores posibles son:
0 - (predeterminado) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.|
|privprotocol|número entero|Protocolo de privacidad SNMPv3. Utilizado solo por interfaces SNMPv3.
Los valores posibles son:
0 - (predeterminado) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.|
|nombre de contexto|cadena|nombre de contexto SNMPv3. Utilizado únicamente por interfaces SNMPv3.|
[comment]: # ({/8d373e4f-3bb71fcc})