Objeto de interfaz de equipo

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

Interfaz del host

El objeto de interfaz del host tiene las siguientes propiedades.

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

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

Valores posibles:
0 - (predeterminado) desconocida;
1 - disponible;
2 - no disponible.

Comportamiento de la propiedad:
- solo lectura
hostid ID ID del host al que pertenece la interfaz.

Comportamiento de la propiedad:
- constante
- obligatoria para operaciones de creación
type integer Tipo de interfaz.

Valores posibles:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
ip string Dirección IP utilizada por la interfaz.

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

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

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

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

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
useip integer Indica si la conexión debe realizarse mediante IP.

Valores posibles:
0 - conectarse utilizando el nombre DNS del host;
1 - conectarse utilizando la dirección IP del host.

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
main integer Indica si la interfaz se utiliza como predeterminada en el host. Solo una interfaz de cada tipo puede establecerse como predeterminada en un host.

Valores posibles:
0 - no predeterminada;
1 - predeterminada.

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
details object Objeto details adicional para la interfaz.

Comportamiento de la propiedad:
- obligatoria si type está establecido en "SNMP"
disable_until timestamp Próximo momento de sondeo de una interfaz de host no disponible.

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

Comportamiento de la propiedad:
- solo lectura
errors_from timestamp Momento en que la interfaz del host dejó de estar disponible.

Comportamiento de la propiedad:
- solo lectura

Detalles

El objeto de detalles tiene las siguientes propiedades.

Property Type Description
version integer Versión de la interfaz SNMP.

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

Comportamiento de la propiedad:
- required
bulk integer Indica si se deben utilizar solicitudes SNMP masivas.

Valores posibles:
0 - no utilizar solicitudes masivas;
1 - (predeterminado) - utilizar solicitudes masivas.
community string Comunidad SNMP. Se utiliza únicamente con interfaces SNMPv1 y SNMPv2.

Comportamiento de la propiedad:
- required si version está establecido en "SNMPv1" o "SNMPv2c"
max_repetitions string Valor máximo de repeticiones para las solicitudes SNMP masivas nativas (GetBulkRequest-PDU).
Se utiliza únicamente para el item walk[] en SNMPv2 y SNMPv3.
Se admiten macros de usuario.

Valores posibles: 1–2147483647 (INT32_MAX).
Predeterminado: 10.
retries string Número máximo de reintentos si se agota el tiempo de espera de una solicitud.
Se utiliza para los items walk[] y get[]. Para walk[], los reintentos se comparten en todo el recorrido.
Se admiten macros de usuario.

Valores posibles: 0–100 (0 - deshabilitar los reintentos).
Predeterminado: 5.
securityname string Nombre de seguridad de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.
securitylevel integer Nivel de seguridad de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.

Valores posibles:
0 - (predeterminado) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Frase de contraseña de autenticación de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.
privpassphrase string Frase de contraseña de privacidad de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.
authprotocol integer Protocolo de autenticación de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.

Valores posibles:
0 - (predeterminado) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer Protocolo de privacidad de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.

Valores posibles:
0 - (predeterminado) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string Nombre de contexto de SNMPv3. Se utiliza únicamente con interfaces SNMPv3.