Documentation
Table of Contents
> Objeto de interfaz de host
Los siguientes objetos están directamente relacionados con la API hostinterface.
Interfaz de host
El objeto de interfaz de host tiene las siguientes propiedades.
Tenga en cuenta que se requieren tanto IP como DNS. Si no desea utilizar DNS, configúrelo en una cadena vacía.
| Propiedad | Tipo | 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.
Etiqueta de detalles
El objeto de detalles tiene las siguientes propiedades.
| Propiedad | Tipo | 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;<br >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;<br >4 - AES192C; 5 - AES256C. |
| nombre de contexto | cadena | nombre de contexto SNMPv3. Utilizado únicamente por interfaces SNMPv3. |