[comment]: # aside: 1
[comment]: # ({94e18e5a-7ed888d2})
# Objeto de interfaz de equipo
Los siguientes objetos están directamente relacionados con la API `hostinterface`.
[comment]: # ({/94e18e5a-7ed888d2})
[comment]: # ({2e033569-ce77a3b0})
### Interfaz de host
El objeto de interfaz de host tiene las siguientes propiedades.
::: noteimportant
Tenga en cuenta que las propiedades `ip` y `dns` son *obligatorias* para las operaciones de creación.
Si no desea utilizar DNS, establezca el valor en una cadena vacía.
:::
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|interfaceid|ID|ID de la interfaz.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*
- *obligatorio* para operaciones de actualización|
|available|integer|Disponibilidad de la interfaz de host.
Valores posibles:
0 - *(por defecto)* desconocido;
1 - disponible;
2 - no disponible.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*|
|hostid|ID|ID del host al que pertenece la interfaz.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *constante*
- *obligatorio* para operaciones de creación|
|type|integer|Tipo de interfaz.
Valores posibles:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|ip|string|Dirección IP utilizada por la interfaz.
Puede estar vacía si la conexión se realiza a través de DNS.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|dns|string|Nombre DNS utilizado por la interfaz.
Puede estar vacío si la conexión se realiza a través de IP.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|port|string|Número de puerto utilizado por la interfaz.
Puede contener macros de usuario.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|useip|integer|Indica si la conexión debe realizarse a través de IP.
Valores posibles:
0 - conectar usando el nombre DNS del host;
1 - conectar usando la dirección IP del host.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|main|integer|Indica si la interfaz se utiliza como predeterminada en el host. Solo una interfaz de un tipo determinado puede establecerse como predeterminada en un host.
Valores posibles:
0 - no predeterminada;
1 - predeterminada.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* para operaciones de creación|
|details|object|Objeto [details](#details) adicional para la interfaz.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio* si `type` se establece en "SNMP"|
|disable\_until|timestamp|La siguiente hora de sondeo de una interfaz de host no disponible.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*|
|error|string|Texto de error si la interfaz de host no está disponible.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*|
|errors\_from|timestamp|Hora en que la interfaz de host dejó de estar disponible.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*|
[comment]: # ({/2e033569-ce77a3b0})
[comment]: # ({58c84008-3bb71fcc})
#### Detalles
El objeto details tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|version|integer|Versión de la interfaz SNMP.
Valores posibles:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido*|
|bulk|integer|Si se deben usar solicitudes SNMP bulk.
Valores posibles:
0 - no usar solicitudes bulk;
1 - (por defecto) - usar solicitudes bulk.|
|community|string|Comunidad SNMP. Se usa solo en las interfaces SNMPv1 y SNMPv2.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* si `version` está configurado como "SNMPv1" o "SNMPv2c"|
|max_repetitions|integer|Valor máximo de repetición para [solicitudes SNMP bulk nativas](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).
Se usa solo para items `discovery[]` y `walk[]` en SNMPv2 y v3.
Por defecto: 10.|
|securityname|string|Nombre de seguridad SNMPv3. Se usa solo en las interfaces SNMPv3.|
|securitylevel|integer|Nivel de seguridad SNMPv3. Se usa solo en las interfaces SNMPv3.
Valores posibles:
0 - (por defecto) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.|
|authpassphrase|string|Frase de autenticación SNMPv3. Se usa solo en las interfaces SNMPv3.|
|privpassphrase|string|Frase de privacidad SNMPv3. Se usa solo en las interfaces SNMPv3.|
|authprotocol|integer|Protocolo de autenticación SNMPv3. Se usa solo en las interfaces SNMPv3.
Valores posibles:
0 - (por defecto) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.|
|privprotocol|integer|Protocolo de privacidad SNMPv3. Se usa solo en las interfaces SNMPv3.
Valores posibles:
0 - (por defecto) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.|
|contextname|string|Nombre de contexto SNMPv3. Se usa solo en las interfaces SNMPv3.|
[comment]: # ({/58c84008-3bb71fcc})