Objeto equipo

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

Host

El objeto host tiene las siguientes propiedades.

Propiedad Tipo Descripción
hostid ID ID del host.

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

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
description text Descripción del host.
flags integer Origen del host.

Valores posibles:
0 - un host normal;
4 - un host convertido a partir de un prototipo.

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

Valores posibles:
-1 - (predeterminado) deshabilitado;
0 - manual;
1 - automático.
ipmi_authtype integer Algoritmo de autenticación IPMI.

Valores posibles:
-1 - (predeterminado) predeterminado;
0 - ninguno;
1 - MD2;
2 - MD5
4 - directo;
5 - OEM;
6 - RMCP+.
ipmi_password string Contraseña de IPMI.
ipmi_privilege integer Nivel de privilegios de IPMI.

Valores posibles:
1 - devolución de llamada;
2 - (predeterminado) usuario;
3 - operador;
4 - administrador;
5 - OEM.
ipmi_username string Nombre de usuario de IPMI.
maintenance_from timestamp Hora de inicio del mantenimiento efectivo.

Comportamiento de la propiedad:
- solo lectura
maintenance_status integer Estado del mantenimiento efectivo.

Valores posibles:
0 - (predeterminado) sin mantenimiento;
1 - mantenimiento activo.

Comportamiento de la propiedad:
- solo lectura
maintenance_type integer Tipo de mantenimiento efectivo.

Valores posibles:
0 - (predeterminado) mantenimiento con recopilación de datos;
1 - mantenimiento sin recopilación de datos.

Comportamiento de la propiedad:
- solo lectura
maintenanceid ID ID del mantenimiento actualmente activo en el host.

Comportamiento de la propiedad:
- solo lectura
name string Nombre visible del host.

Predeterminado: valor de la propiedad host.
monitored_by integer Origen utilizado para monitorizar el host.

Valores posibles:
0 - (predeterminado) Zabbix server;
1 - proxy;
2 - grupo de proxies.

Comportamiento de la propiedad:
- obligatoria si select_server_for_monitoring está establecido en "Disabled".
proxyid ID ID del proxy utilizado para monitorizar el host.

Comportamiento de la propiedad:
- obligatoria si monitored_by está establecido en "Proxy"
proxy_groupid ID ID del grupo de proxies utilizado para monitorizar el host.

Comportamiento de la propiedad:
- obligatoria si monitored_by está establecido en "Proxy group"
status integer Estado y función del host.

Valores posibles:
0 - (predeterminado) habilitado;
1 - deshabilitado.
tls_connect integer Conexiones al host.

Valores posibles:
1 - (predeterminado) sin cifrado;
2 - PSK;
4 - certificado.
tls_accept integer Conexiones desde el host.

Valores de bitmap posibles:
1 - (predeterminado) sin cifrado;
2 - PSK;
4 - certificado.

Este es un campo de máscara de bits; se acepta cualquier suma de los valores de bitmap posibles (por ejemplo, 6 para PSK y certificado).
tls_issuer string Emisor del certificado.
tls_subject string Asunto del certificado.
tls_psk_identity string Identidad de PSK; debe asociarse con una sola PSK (entre autoregistro, hosts y proxies).

No incluya información confidencial en la identidad de PSK, ya que se envía sin cifrar a través de la red para informar al receptor de qué PSK debe utilizar.

Comportamiento de la propiedad:
- solo escritura
- obligatoria si tls_connect está establecido en "PSK" o si tls_accept contiene el bit "PSK"
tls_psk string Clave precompartida (PSK); debe contener al menos 32 dígitos hexadecimales.

Comportamiento de la propiedad:
- solo escritura
- obligatoria si tls_connect está establecido en "PSK" o si tls_accept contiene el bit "PSK"
active_available integer Estado de disponibilidad de la interfaz activa del host.

Valores posibles:
0 - se desconoce el estado de la interfaz;
1 - la interfaz está disponible;
2 - la interfaz no está disponible.

Comportamiento de la propiedad:
- solo lectura
assigned_proxyid ID ID del proxy asignado por Zabbix server, si el host está monitorizado por un grupo de proxies.

Comportamiento de la propiedad:
- solo lectura

Inventario de host

El objeto de inventario de host tiene las siguientes propiedades.

Cada propiedad tiene su propio número de ID único, que se utiliza para asociar los campos de inventario de host con los items.

ID Propiedad Tipo Descripción Longitud máxima
4 alias string Alias. 128 caracteres
11 asset_tag string Etiqueta de activo. 64 caracteres
28 chassis string Chasis. 64 caracteres
23 contact string Persona de contacto. 65535 caracteres para bases de datos SQL
32 contract_number string Número de contrato. 64 caracteres
47 date_hw_decomm string Fecha de baja del hardware. 64 caracteres
46 date_hw_expiry string Fecha de vencimiento del mantenimiento del hardware. 64 caracteres
45 date_hw_install string Fecha de instalación del hardware. 64 caracteres
44 date_hw_purchase string Fecha de compra del hardware. 64 caracteres
34 deployment_status string Estado de despliegue. 64 caracteres
14 hardware string Hardware. 255 caracteres
15 hardware_full string Hardware detallado. 65535 caracteres para bases de datos SQL
39 host_netmask string Máscara de subred del host. 39 caracteres
38 host_networks string Redes del host. 65535 caracteres para bases de datos SQL
40 host_router string Router del host. 39 caracteres
30 hw_arch string Arquitectura de hardware. 32 caracteres
33 installer_name string Nombre del instalador. 64 caracteres
24 location string Ubicación. 65535 caracteres para bases de datos SQL
25 location_lat string Latitud de la ubicación. 16 caracteres
26 location_lon string Longitud de la ubicación. 16 caracteres
12 macaddress_a string Dirección MAC A. 64 caracteres
13 macaddress_b string Dirección MAC B. 64 caracteres
29 model string Modelo. 64 caracteres
3 name string Nombre. 128 caracteres
27 notes string Notas. 65535 caracteres para bases de datos SQL
41 oob_ip string Dirección IP OOB. 39 caracteres
42 oob_netmask string Máscara de subred OOB. 39 caracteres
43 oob_router string Router OOB. 39 caracteres
5 os string Nombre del sistema operativo. 128 caracteres
6 os_full string Nombre detallado del sistema operativo. 255 caracteres
7 os_short string Nombre corto del sistema operativo. 128 caracteres
61 poc_1_cell string Número móvil del POC primario. 64 caracteres
58 poc_1_email string Correo electrónico primario. 128 caracteres
57 poc_1_name string Nombre del POC primario. 128 caracteres
63 poc_1_notes string Notas del POC primario. 65535 caracteres para bases de datos SQL
59 poc_1_phone_a string Teléfono A del POC primario. 64 caracteres
60 poc_1_phone_b string Teléfono B del POC primario. 64 caracteres
62 poc_1_screen string Nombre de pantalla del POC primario. 64 caracteres
68 poc_2_cell string Número móvil del POC secundario. 64 caracteres
65 poc_2_email string Correo electrónico secundario del POC. 128 caracteres
64 poc_2_name string Nombre del POC secundario. 128 caracteres
70 poc_2_notes string Notas del POC secundario. 65535 caracteres para bases de datos SQL
66 poc_2_phone_a string Teléfono A del POC secundario. 64 caracteres
67 poc_2_phone_b string Teléfono B del POC secundario. 64 caracteres
69 poc_2_screen string Nombre de pantalla del POC secundario. 64 caracteres
8 serialno_a string Número de serie A. 64 caracteres
9 serialno_b string Número de serie B. 64 caracteres
48 site_address_a string Dirección del sitio A. 128 caracteres
49 site_address_b string Dirección del sitio B. 128 caracteres
50 site_address_c string Dirección del sitio C. 128 caracteres
51 site_city string Ciudad del sitio. 128 caracteres
53 site_country string País del sitio. 64 caracteres
56 site_notes string Notas del sitio. 65535 caracteres para bases de datos SQL
55 site_rack string Ubicación del rack del sitio. 128 caracteres
52 site_state string Estado del sitio. 64 caracteres
54 site_zip string Código postal del sitio. 64 caracteres
16 software string Software. 255 caracteres
18 software_app_a string Aplicación de software A. 64 caracteres
19 software_app_b string Aplicación de software B. 64 caracteres
20 software_app_c string Aplicación de software C. 64 caracteres
21 software_app_d string Aplicación de software D. 64 caracteres
22 software_app_e string Aplicación de software E. 64 caracteres
17 software_full string Detalles del software. 65535 caracteres para bases de datos SQL
10 tag string Etiqueta. 64 caracteres
1 type string Tipo. 64 caracteres
2 type_full string Detalles del tipo. 64 caracteres
35 url_a string URL A. 2048 caracteres
36 url_b string URL B. 2048 caracteres
37 url_c string URL C. 2048 caracteres
31 vendor string Proveedor. 64 caracteres

Etiqueta de host

El objeto de etiqueta de host tiene las siguientes propiedades.

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

Comportamiento de la propiedad:
- requerido
value string Valor de la etiqueta de host.

Comportamiento de la propiedad:
- solo lectura.
automatic integer Tipo de etiqueta de host.

Valores posibles:
0 - (por defecto) manual (etiqueta creada por el usuario);
1 - automática (etiqueta creada por el descubrimiento de bajo nivel)

Comportamiento de la propiedad:
- solo lectura
object integer Tipo de objeto del que se heredó la etiqueta.

Valores posibles:
0 - template.

Comportamiento de la propiedad:
- solo lectura.
objectid ID ID del objeto del que se heredó la etiqueta.

Comportamiento de la propiedad:
- solo lectura.