Los siguientes objetos están directamente relacionados con la API hostinterface
.
El objeto de interfaz de host tiene las siguientes propiedades.
Tenga en cuenta que las propiedades ip
y dns
son obligatorias para las operaciones de creación. Si no desea usar 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 host. Valores posibles: 0 - (por defecto) desconocido; 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 - 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 host; 1 - conectar usando la dirección IP del host. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
main | entero | Indica si la interfaz se utiliza como predeterminada en el host. Solo una interfaz de un tipo determinado puede establecerse como predeterminada en un host. 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 se establece en "SNMP" |
disable_until | marca de tiempo | La siguiente hora de sondeo de una interfaz de host no disponible. Comportamiento de la propiedad: - solo lectura |
error | cadena | Texto de error si la interfaz de host no está disponible. Comportamiento de la propiedad: - solo lectura |
errors_from | marca de tiempo | Hora en que la interfaz de host dejó de estar disponible. Comportamiento de la propiedad: - solo lectura |
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: - requerido |
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: - requerido 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. |