Objeto prototipo de equipo

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

Prototipo de host

El objeto prototipo de host tiene las siguientes propiedades.

Propiedad Tipo Descripción
hostid ID ID del prototipo de host.

Comportamiento de la propiedad:
- solo lectura
- requerido para operaciones de actualización
host string Nombre técnico del prototipo de host.

Comportamiento de la propiedad:
- requerido para operaciones de creación
- solo lectura para objetos heredados
name string Nombre visible del prototipo de host.

Por defecto: valor de la propiedad host.

Comportamiento de la propiedad:
- solo lectura para objetos heredados
status integer Estado del prototipo de host.

Valores posibles:
0 - (por defecto) host monitorizado;
1 - host no monitorizado.
flags integer Origen del prototipo de host.

Valores posibles:
2 - un prototipo de host;
6 - un prototipo de host descubierto

Comportamiento de la propiedad:
- solo lectura
inventory_mode integer Modo de población del inventario del host.

Valores posibles:
-1 - (por defecto) deshabilitado;
0 - manual;
1 - automático.
templateid ID ID del prototipo de host de la template padre.

Comportamiento de la propiedad:
- solo lectura
discover integer Estado de descubrimiento del prototipo de host.

Valores posibles:
0 - (por defecto) se descubrirán nuevos hosts;
1 - no se descubrirán nuevos hosts y los hosts existentes se marcarán como perdidos.
custom_interfaces integer Fuente de interfaces personalizadas para los hosts creados por el prototipo de host.

Valores posibles:
0 - (por defecto) heredar interfaces del host padre;
1 - usar interfaces personalizadas de los prototipos de host.

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

Comportamiento de la propiedad:
- soportado si el prototipo de host pertenece a una 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.

Propiedad Tipo Descripción
tag string Nombre de la etiqueta del prototipo de host.

Comportamiento de la propiedad:
- requerido
value string Valor de la etiqueta del 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:
- obligatorio
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:
- obligatorio
ip string Dirección IP utilizada por la interfaz.
Puede contener macros.

Comportamiento de la propiedad:
- obligatorio 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:
- obligatorio 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:
- obligatorio
main integer Si la interfaz se utiliza como predeterminada en el host.
Solo se puede establecer una interfaz de algún tipo como predeterminada en un host.

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

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

Comportamiento de la propiedad:
- obligatorio 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:
- obligatorio
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:
- obligatorio si version está establecido en "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á establecido en "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á establecido en "SNMPv3"
authpassphrase string Frase de autenticación SNMPv3.

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

Comportamiento de la propiedad:
- soportado si version está establecido en "SNMPv3" y securitylevel está establecido en "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á establecido en "SNMPv3" y securitylevel está establecido en "authNoPriv" o "authPriv"
privprotocol integer Protocolo de privacidad SNMPv3. Se usa solo para 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á establecido en "SNMPv3" y securitylevel está establecido en "authPriv"
contextname string Nombre de contexto SNMPv3.

Comportamiento de la propiedad:
- soportado si version está establecido en "SNMPv3"