Objeto prototipo de equipo

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

Prototipo de equipo

El objeto prototipo de equipo tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
hostid	ID	ID del prototipo de equipo. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización
host	string	Nombre técnico del prototipo de equipo. Comportamiento de la propiedad: - obligatorio para operaciones de creación - solo lectura para objetos heredados
name	string	Nombre visible del prototipo de equipo. Por defecto: valor de la propiedad `host`. Comportamiento de la propiedad: - solo lectura para objetos heredados
status	integer	Estado del prototipo de equipo. Valores posibles: 0 - (por defecto) equipo monitorizado; 1 - equipo no monitorizado.
flags	integer	Origen del prototipo de equipo. Valores posibles: 2 - un prototipo de equipo; 6 - un prototipo de equipo descubierto Comportamiento de la propiedad: - solo lectura
inventory_mode	integer	Modo de población del inventario del equipo. Valores posibles: -1 - (por defecto) deshabilitado; 0 - manual; 1 - automático.
templateid	ID	ID del prototipo de equipo plantilla padre. Comportamiento de la propiedad: - solo lectura
discover	integer	Estado de descubrimiento del prototipo de equipo. Valores posibles: 0 - (por defecto) se descubrirán nuevos equipos; 1 - no se descubrirán nuevos equipos y los equipos existentes se marcarán como perdidos.
custom_interfaces	integer	Fuente de interfaces personalizadas para los equipos creados por el prototipo de equipo. Valores posibles: 0 - (por defecto) heredar interfaces del equipo padre; 1 - usar interfaces personalizadas de los prototipos de equipo. Comportamiento de la propiedad: - solo lectura para objetos heredados
uuid	string	Identificador único universal, utilizado para vincular prototipos de equipo importados con los ya existentes. Se genera automáticamente si no se proporciona. Comportamiento de la propiedad: - soportado si el prototipo de equipo pertenece a una plantilla

Enlace de grupo

El objeto de enlace de grupo vincula un prototipo de equipo con un grupo de equipos. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
groupid	ID	ID del grupo de equipos. Comportamiento de la propiedad: - requerido

Prototipo de grupo

El objeto prototipo de grupo define un grupo que se creará para un equipo 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 equipo

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

Propiedad	Tipo	Descripción
tag	string	Nombre de la etiqueta del prototipo de equipo. Comportamiento de la propiedad: - obligatorio
value	string	Valor de la etiqueta del prototipo de equipo.

Interfaz personalizada

Se admiten interfaces personalizadas 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	entero	Tipo de interfaz. Valores posibles: 1 - Agente; 2 - SNMP; 3 - IPMI; 4 - JMX. Comportamiento de la propiedad: - obligatorio
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
ip	cadena	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	cadena	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	cadena	Número de puerto utilizado por la interfaz. Puede contener macros de usuario y LLD. Comportamiento de la propiedad: - obligatorio
main	entero	Indica 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: - obligatorio
details	objeto	Objeto adicional para detalles de interfaz personalizada. Comportamiento de la propiedad: - obligatorio si `type` está configurado en "SNMP"

Detalles de la interfaz personalizada

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. Comportamiento de la propiedad: - requerido 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 métricas `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 en 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"

Documentation