Documentation
Table of Contents
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 | ID | ID de la interfaz. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| available | entero | Disponibilidad de la interfaz del equipo. Valores posibles: 0 - (predeterminado) desconocido; 1 - disponible; 2 - no disponible. <br >Comportamiento de la propiedad: - solo lectura |
| hostid | ID | 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 | entero | Si la conexión debe realizarse a través de IP. Valores posibles: 0: conectarse usando el nombre DNS del equipo; 1: conectarse usando la dirección IP del equipo. <br >Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| main | entero | Si la interfaz se utiliza de forma predeterminada en el host. Solo se puede configurar una interfaz de algún tipo como predeterminada en un host. Valores posibles: 0: no predeterminado; 1: predeterminado. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| details | matriz | Objetoadicional de detalles 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 equipo no disponible. Comportamiento de la propiedad: - solo lectura |
| error | cadena | Texto de error si la interfaz del equipo 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 details 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 | entero | Indica si se deben usar solicitudes SNMP bulk. Valores posibles: 0 - no usar solicitudes bulk; 1 - (por defecto) - usar solicitudes bulk. |
| community | cadena | Comunidad SNMP. Se utiliza solo en las interfaces SNMPv1 y SNMPv2. Comportamiento de la propiedad: - obligatorio si version está establecido en "SNMPv1" o "SNMPv2c" |
| max_repetitions | entero | Valor máximo de repetición para solicitudes SNMP bulk nativas (GetBulkRequest-PDUs). Se utiliza solo para los elementos discovery[] y walk[] en SNMPv2 y v3.Por defecto: 10. |
| securityname | cadena | Nombre de seguridad SNMPv3. Se utiliza solo en las interfaces SNMPv3. |
| securitylevel | entero | Nivel de seguridad SNMPv3. Se utiliza solo en las interfaces SNMPv3. Valores posibles: 0 - (por defecto) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
| authpassphrase | cadena | Frase de autenticación SNMPv3. Se utiliza solo en las interfaces SNMPv3. |
| privpassphrase | cadena | Frase de privacidad SNMPv3. Se utiliza solo en las interfaces SNMPv3. |
| authprotocol | entero | Protocolo de autenticación SNMPv3. Se utiliza solo en las interfaces SNMPv3. Valores posibles: 0 - (por defecto) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. |
| privprotocol | entero | Protocolo de privacidad SNMPv3. Se utiliza solo en las interfaces SNMPv3. Valores posibles: 0 - (por defecto) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. |
| contextname | cadena | Nombre de contexto SNMPv3. Se utiliza solo en las interfaces SNMPv3. |