Los siguientes objetos están directamente relacionados con la API hostinterface
.
El objeto de interfaz de equipo tiene las siguientes propiedades.
Tenga en cuenta que las propiedades ip
y dns
son obligatorias para las operaciones de creación. Si no desea utilizar DNS, establézcalo como 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 de equipo. Valores posibles: 0 - (por defecto) desconocido; 1 - disponible; 2 - no disponible. Comportamiento de la propiedad: - solo lectura |
hostid | ID | ID del equipo al que pertenece la interfaz. Comportamiento de la propiedad: - constante - obligatorio para operaciones de creación |
type | entero | Tipo de interfaz. Valores posibles: 1 - Agente; 2 - SNMP; 3 - IPMI; 4 - JMX. 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 mediante 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 operaciones de creación |
useip | entero | Indica si la conexión debe realizarse mediante IP. Valores posibles: 0 - conectar usando el nombre DNS del equipo; 1 - conectar usando la dirección IP del equipo. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
main | entero | Indica si la interfaz se utiliza como predeterminada en el equipo. Solo una interfaz de un tipo determinado puede establecerse como predeterminada en un equipo. Valores posibles: 0 - no predeterminada; 1 - predeterminada. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
details | objeto | Objeto detalles adicional para la interfaz. Comportamiento de la propiedad: - obligatorio si type está establecido en "SNMP" |
disable_until | marca de tiempo | 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 de equipo no está disponible. Comportamiento de la propiedad: - solo lectura |
errors_from | marca de tiempo | Hora en que la interfaz de equipo dejó de estar disponible. Comportamiento de la propiedad: - solo lectura |
El objeto details tiene las siguientes propiedades.
Propiedad | Tipo | Descripción |
---|---|---|
version | integer | Versión de la interfaz SNMP. Valores posibles: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3. Comportamiento de la propiedad: - requerido |
bulk | integer | Indica 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 utiliza solo en las interfaces SNMPv1 y SNMPv2. Comportamiento de la propiedad: - requerido si version está configurado como "SNMPv1" o "SNMPv2c" |
max_repetitions | integer | Valor máximo de repetición para solicitudes SNMP bulk nativas (GetBulkRequest-PDUs). Se utiliza solo para métricas discovery[] y walk[] en SNMPv2 y v3.Por defecto: 10. |
securityname | string | Nombre de seguridad SNMPv3. Se utiliza solo en las interfaces SNMPv3. |
securitylevel | integer | Nivel de seguridad SNMPv3. Se utiliza solo en las interfaces SNMPv3. Valores posibles: 0 - (por defecto) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
authpassphrase | string | Frase de autenticación SNMPv3. Se utiliza solo en las interfaces SNMPv3. |
privpassphrase | string | Frase de privacidad SNMPv3. Se utiliza solo en las interfaces SNMPv3. |
authprotocol | integer | 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 | integer | 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 | string | Nombre de contexto SNMPv3. Se utiliza solo en las interfaces SNMPv3. |