> Objeto de interfaz de equipo

Los siguientes objetos están directamente relacionados con la API hostinterface.

Interfaz de equipo

El objeto de interfaz de equipo tiene las siguientes propiedades.

Tenga en cuenta que las propiedades ip y dns son requeridas para las operaciones de creación. Si no desea utilizar DNS, configúrelo en una cadena vacía.

Propiedad Tipo Descripción
interfaceid cadena ID de la interfaz.

Comportamiento de la propiedad:
- solo lectura
- obligatorio para operaciones de actualización
available entero Disponibilidad de la interfaz del host.

Valores posibles:
0 - (predeterminado) desconocido;
1 - disponible;
2 - no disponible.
<br >Comportamiento de la propiedad:
- solo lectura
hostid cadena ID del equipo al que pertenece la interfaz.

Comportamiento de la propiedad:
- constante
- requerido para crear operaciones
type entero Tipo de interfaz.

Valores posibles:
1 - Agente;
2 - SNMP;
3 - IPMI;
4 - JMX.
<br >Comportamiento de la propiedad:
- obligatorio para operaciones de creación
ip cadena Dirección IP utilizada por la interfaz.

Puede estar vacía si la conexión se realiza mediante DNS.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
dns cadena Nombre DNS utilizado por la interfaz.

Puede estar vacío si la conexión se realiza vía IP.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
port cadena Número de puerto utilizado por la interfaz.
Puede contener macros de usuario.

Comportamiento de la propiedad:
- obligatorio para crear operaciones
useip integer Si la conexión debe realizarse a través de IP.

Valores posibles:
0: conectarse usando el nombre DNS del host;
1: conectarse usando la dirección IP del equipo.
<br >Comportamiento de la propiedad:
- obligatorio para operaciones de creación
main integer Si la interfaz se utiliza de forma predeterminada en el equipo. Solo se puede configurar una interfaz de algún tipo como predeterminada en un equipo.

Valores posibles:
0: no predeterminado;
1: predeterminado.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
details matriz Objeto detalles adicional para la interfaz.

Comportamiento de la propiedad:
- obligatorio si tipo está configurado en "SNMP"
disable_until timestamp La próxima hora de sondeo de una interfaz de host no disponible.

Comportamiento de la propiedad:
- solo lectura
error cadena Texto de error si la interfaz del host no está disponible.

Comportamiento de la propiedad:
- solo lectura
errors_from marca de tiempo Hora en que la interfaz del equipo dejó de estar disponible.

Comportamiento de la propiedad:
- solo lectura

Detalles

El objeto de detalles tiene las siguientes propiedades.

Propiedad Tipo Descripción
version entero Versión de la interfaz SNMP.

Valores posibles:
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3.

Comportamiento de la propiedad:
- obligatorio
bulk integer Si se deben usar solicitudes SNMP masivas.

Valores posibles:
0 - no usar solicitudes masivas;
1 - (predeterminado) - usar solicitudes masivas.
community cadena Comunidad SNMP. Usado solo por interfaces SNMPv1 y SNMPv2.

Comportamiento de la propiedad:
- obligatorio si versión está configurada en "SNMPv1" o " SNMPv2c"
max_repetitions integer Valor máximo de repetición para solicitudes masivas SNMP nativas (GetBulkRequest-PDU).
Se usa solo para elementos discovery[] y walk[] en SNMPv2 y v3.

Predeterminado: 10.
securityname cadena nombre de seguridad SNMPv3. Utilizado únicamente por interfaces SNMPv3.
securitylevel entero Nivel de seguridad SNMPv3. Utilizado solo por interfaces SNMPv3.

Valores posibles:
0 - (predeterminado) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase cadena frase de contraseña de autenticación SNMPv3. Utilizado únicamente por interfaces SNMPv3.
privpassphrase 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.

Valores posibles:
0 - (predeterminado) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol entero Protocolo de privacidad SNMPv3. Utilizado solo por interfaces SNMPv3.

Valores posibles:
0 - (predeterminado) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname cadena nombre de contexto SNMPv3. Utilizado únicamente por interfaces SNMPv3.