Documentation
Table of Contents
> Objeto prototipo de host
Los siguientes objetos están directamente relacionados con la API hostprototype.
Prototipo de host
El objeto de prototipo de host tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| hostid | cadena | (solo lectura) ID del prototipo de host. |
| host (obligatorio) |
cadena | Nombre técnico del prototipo de host. |
| nombre | cadena | Nombre visible del prototipo de host. Predeterminado: valor de propiedad host. |
| estado | número entero | Estado del prototipo de host. Los valores posibles son: 0 - (predeterminado) host monitoreado; 1 - host no monitoreado. |
| inventario_modo | número entero | Modo de llenado del inventario del host. Los valores posibles son: -1 - (predeterminado) deshabilitado; 0 - manual; 1 - automático. |
| templateid | cadena | (readonly) ID del prototipo de host de la template principal. |
| descubrir | número entero | Estado de descubrimiento del prototipo de host. Valores posibles: 0 - (predeterminado) se descubrirán nuevos hosts; 1 - no se descubrirán nuevos hosts y los existentes serán marcados como perdidos. |
| personalizar_interfaces | número entero | Fuente de interfaces para hosts creados por el prototipo de host. Valores posibles: 0 - (predeterminado) hereda interfaces del host principal; 1 - usa host prototipos de interfaces personalizadas. |
| uuid | cadena | Identificador único universal, utilizado para vincular prototipos de host importados con los ya existentes. Se utiliza únicamente para prototipos de host en templates. Generado automáticamente, si no se proporciona. |
Tenga en cuenta que para algunos métodos (actualizar, eliminar) la combinación de parámetros requeridos/opcionales es diferente.
Enlace de grupo
El objeto de enlace de grupo vincula un prototipo de host con un grupo de hosts y tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| groupid (obligatorio) |
cadena | ID del grupo de host. |
Prototipo de grupo
El objeto de prototipo de grupo define un grupo que será creado para un host descubierto y tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| nombre (obligatorio) |
cadena | Nombre del prototipo del grupo. |
Etiqueta de prototipo de host
El objeto de etiqueta del prototipo de host tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| etiqueta (obligatorio) |
cadena | Nombre de etiqueta del prototipo de host. |
| valor | cadena | Valor de etiqueta del prototipo de host. |
Interfaz personalizada
El objeto de interfaz personalizada tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| dns | cadena | Nombre DNS utilizado por la interfaz. Obligatorio si la conexión se realiza a través de DNS. Puede contener macros. |
| ip | cadena | Dirección IP utilizada por la interfaz. Obligatorio si la conexión se realiza vía IP. Puede contener macros. |
| 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 y LLD. |
| 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. 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. |
| detalles | matriz | Objeto adicional para interfaz. Obligatorio si el 'tipo' de interfaz es SNMP. |
Detalles de la interfaz personalizada
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 |
| masivo | número entero | Si se deben usar solicitudes SNMP masivas. Los valores posibles son: 0 - no usar solicitudes masivas; 1 - (predeterminado) - usar solicitudes masivas. |
| comunidad | cadena | Comunidad SNMP. 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 | número entero | Protocolo de autenticación SNMPv3. Utilizado solo por interfaces SNMPv3. Los valores posibles son: 0 - (predeterminado) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. |
| privprotocol | entero | Protocolo de privacidad SNMPv3. Utilizado solo por interfaces SNMPv3. Los valores posibles son: 0 - (predeterminado) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. |
| nombre de contexto | cadena | nombre de contexto SNMPv3. Utilizado únicamente por interfaces SNMPv3. |