Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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

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

Propiedad Tipo Descripción
type integer Tipo de interfaz.

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

Comportamiento de la propiedad:
- requerido
useip integer Indica si la conexión debe realizarse mediante IP.

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

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 equipo"
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 equipo"
port string Número de puerto utilizado por la interfaz.
Puede contener macros de usuario y LLD.

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

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

Comportamiento de la propiedad:
- requerido
details array 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 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"