Objeto prototipo de equipo

Los siguientes objetos están directamente relacionados con la API hostprototype.

Prototipo de host

El objeto de prototipo de host tiene las siguientes propiedades.

Property Type Description
hostid ID ID del prototipo de host.

Property behavior:
- solo lectura
- obligatorio para operaciones de actualización
host string Nombre técnico del prototipo de host.

Property behavior:
- obligatorio para operaciones de creación
- solo lectura para objetos heredados
name string Nombre visible del prototipo de host.

Predeterminado: valor de la propiedad host.

Property behavior:
- solo lectura para objetos heredados
status integer Estado del prototipo de host.

Valores posibles:
0 - (predeterminado) host monitorizado;
1 - host no monitorizado.
inventory_mode integer Modo de población del inventario del host.

Valores posibles:
-1 - (predeterminado) deshabilitado;
0 - manual;
1 - automático.
templateid ID ID del template host principal del prototipo.

Property behavior:
- solo lectura
discover integer 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 hosts existentes se marcarán como perdidos.
custom_interfaces integer Origen de las interfaces personalizadas para los hosts creados por el prototipo de host.

Valores posibles:
0 - (predeterminado) heredar las interfaces del host principal;
1 - usar las interfaces personalizadas del prototipo de host.

Property behavior:
- solo lectura para objetos heredados
uuid string Identificador único universal, utilizado para vincular los prototipos de host importados con los ya existentes. Se genera automáticamente si no se proporciona.

Property behavior:
- compatible si el prototipo de host pertenece a un template

Enlace de grupo

El objeto de enlace de grupo vincula un prototipo de host con un grupo de hosts. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
groupid ID ID del grupo de hosts.

Comportamiento de la propiedad:
- obligatorio

Prototipo de grupo

El objeto prototipo de grupo define un grupo que se creará para un host descubierto. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
group_prototypeid ID ID del prototipo de grupo.

Comportamiento de la propiedad:
- solo lectura
name string Nombre del prototipo de grupo.

Comportamiento de la propiedad:
- requerido para operaciones de creación

Etiqueta de prototipo de host

El objeto de etiqueta de prototipo de host tiene las siguientes propiedades.

Property Type Description
tag string Nombre de la etiqueta de prototipo de host.

Property behavior:
- required
value string Valor de la etiqueta de prototipo de host.

Interfaz personalizada

Las interfaces personalizadas son compatibles si custom_interfaces del objeto prototipo de host está configurado en "usar interfaces personalizadas de prototipos de host". El objeto de interfaz personalizada tiene las siguientes propiedades.

Propiedad Tipo Descripción
type integer Tipo de interfaz.

Valores posibles:
1 - Agent;
2 - SNMP;
3 - IPMI;
4 - JMX.

Comportamiento de la propiedad:
- requerido
useip integer Si la conexión debe realizarse a través de IP.

Valores posibles:
0 - conectar usando el nombre DNS del host;
1 - conectar usando la dirección IP del host.

Comportamiento de la propiedad:
- requerido
ip string Dirección IP utilizada por la interfaz.
Puede contener macros.

Comportamiento de la propiedad:
- requerido si useip está configurado en "conectar usando la dirección IP del host"
dns string Nombre DNS utilizado por la interfaz.
Puede contener macros.

Comportamiento de la propiedad:
- requerido si useip está configurado en "conectar usando el nombre DNS del host"
port string Número de puerto utilizado por la interfaz.
Puede contener macros de usuario y LLD.

Comportamiento de la propiedad:
- requerido
main integer Si la interfaz se utiliza como predeterminada en el host.
Solo una interfaz de algún tipo puede establecerse como predeterminada en un host.

Valores posibles:
0 - no predeterminada;
1 - predeterminada.

Comportamiento de la propiedad:
- requerido
details object Objeto adicional para detalles de la interfaz personalizada.

Comportamiento de la propiedad:
- requerido si type está configurado en "SNMP"

Detalles de la interfaz personalizada

El objeto de detalles 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 Si se deben usar solicitudes SNMP bulk.

Valores posibles:
0 - no usar solicitudes bulk;
1 - (por defecto) - usar solicitudes bulk.
community string Comunidad SNMP.

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 usa solo para items discovery[] y walk[] en SNMPv2 y v3.

Por defecto: 10.
securityname string Nombre de seguridad SNMPv3.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3"
securitylevel integer Nivel de seguridad SNMPv3.

Valores posibles:
0 - (por defecto) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3"
authpassphrase string Frase de autenticación SNMPv3.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3" y securitylevel está configurado como "authNoPriv" o "authPriv"
privpassphrase string Frase de privacidad SNMPv3.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3" y securitylevel está configurado como "authPriv"
authprotocol integer Protocolo de autenticación SNMPv3.

Valores posibles:
0 - (por defecto) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3" y securitylevel está configurado como "authNoPriv" o "authPriv"
privprotocol integer Protocolo de privacidad SNMPv3. Usado solo por interfaces SNMPv3.

Valores posibles:
0 - (por defecto) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3" y securitylevel está configurado como "authPriv"
contextname string Nombre de contexto SNMPv3.

Comportamiento de la propiedad:
- soportado si version está configurado como "SNMPv3"