Los siguientes objetos están directamente relacionados con la API hostprototype.
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 | cadena | Nombre técnico del prototipo de equipo. Comportamiento de la propiedad: - obligatorio para las operaciones de creación - * sólo lectura* para objetos heredados |
| nombre | cadena | Nombre visible del prototipo de equipo. Predeterminado: valor de propiedad host.Comportamiento de la propiedad:< br>- solo lectura para objetos heredados |
| status | entero | Estado del prototipo de equipo. Valores posibles: 0 - (predeterminado) host monitoreado; 1 - host no monitoreado. |
| inventory_mode | entero | Modo de llenado del inventario del equipo. Valores posibles: -1 - (predeterminado) deshabilitado; 0 - manual; 1 - automático. |
| templateid | ID | ID del prototipo de equipo de plantilla principal. Comportamiento de la propiedad: - solo lectura |
| discover | entero | Estado de descubrimiento del prototipo de equipo. Valores posibles: 0 - (predeterminado) se descubrirán nuevos hosts; 1 - no se descubrirán nuevos hosts y los existentes sí. ser marcado como perdido. |
| custom_interfaces | entero | Origen de interfaces personalizadas para equipos creados por el prototipo de equipo. Valores posibles: 0 - (predeterminado) heredar interfaces del padre host; 1 - utilice interfaces personalizadas de prototipos de equipo. Comportamiento de la propiedad: - solo lectura para objetos heredados |
| uuid | cadena | Identificador único universal, utilizado para vincular prototipos de equipo importados con los ya existentes. Generado automáticamente, si no se proporciona. Comportamiento de la propiedad: - compatible si el prototipo de equipo pertenece a una plantilla |
El objeto de enlace a 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: - obligatorio |
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 |
El objeto de etiqueta del prototipo de equipo tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | cadena | Nombre de etiqueta del prototipo de equipo. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor de etiqueta del prototipo de equipo. |
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 | array | Objeto adicional para detalles de interfaz personalizada. Comportamiento de la propiedad: - obligatorio si type está configurado en "SNMP" |
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: - obligatorio |
| 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. Comportamiento de la propiedad: - obligatorio 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 elementos discovery[] y walk[] en SNMPv2 y v3.Por defecto: 10. |
| securityname | cadena | Nombre de seguridad SNMPv3. Comportamiento de la propiedad: - soportado si version está establecido en "SNMPv3" |
| securitylevel | entero | 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 | cadena | 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 | cadena | Frase de privacidad SNMPv3. Comportamiento de la propiedad: - soportado si version está establecido en "SNMPv3" y securitylevel está establecido en "authPriv" |
| authprotocol | entero | 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 | entero | Protocolo de privacidad SNMPv3. Se utiliza 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 | cadena | Nombre de contexto SNMPv3. Comportamiento de la propiedad: - soportado si version está establecido en "SNMPv3" |