Objeto de equipo

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

Host

El objeto host tiene las siguientes propiedades.

Propiedad Tipo Descripción
hostid ID ID del host.

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

Comportamiento de la propiedad:
- requerido para operaciones de creación
description texto Descripción del host.
flags entero Origen del host.

Valores posibles:
0 - un host simple;
4 - un host descubierto.

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

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

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

Valores posibles:
1 - callback;
2 - (por defecto) usuario;
3 - operador;
4 - admin;
5 - OEM.
ipmi_username string Nombre de usuario IPMI.
maintenance_from timestamp Hora de inicio del mantenimiento efectivo.

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

Valores posibles:
0 - (por defecto) sin mantenimiento;
1 - mantenimiento en vigor.

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

Valores posibles:
0 - (por defecto) mantenimiento con recolección de datos;
1 - mantenimiento sin recolección de datos.

Comportamiento de la propiedad:
- solo lectura
maintenanceid ID ID del mantenimiento que está actualmente en vigor en el host.

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

Por defecto: valor de la propiedad host.
monitored_by entero Fuente que se utiliza para monitorizar el host.

Valores posibles:
0 - (por defecto) servidor Zabbix;
1 - Proxy;
2 - Grupo de proxies.
proxyid ID ID del proxy que se utiliza para monitorizar el host.

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

Comportamiento de la propiedad:
- requerido si monitored_by está establecido en "Grupo de proxies"
status entero Estado y función del host.

Valores posibles:
0 - (por defecto) habilitado;
1 - deshabilitado.
tls_connect entero Conexiones al host.

Valores posibles:
1 - (por defecto) Sin cifrado;
2 - PSK;
4 - certificado.
tls_accept entero Conexiones desde el host.

Valores posibles de mapa de bits:
1 - (por defecto) Sin cifrado;
2 - PSK;
4 - certificado.

Este es un campo de máscara de bits; cualquier suma de los valores posibles es aceptable (por ejemplo, 6 para PSK y certificado).
tls_issuer string Emisor del certificado.
tls_subject string Sujeto del certificado.
tls_psk_identity string Identidad PSK; debe estar emparejada con solo una PSK (entre autoregistro, hosts y proxies).

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

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

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

Valores posibles:
0 - el estado de la interfaz es desconocido;
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 el servidor Zabbix, si el host es monitorizado por un grupo de proxies.

Comportamiento de la propiedad:
- solo lectura

Inventario de equipo

El objeto de inventario del equipo tiene las siguientes propiedades.

Cada propiedad tiene su propio número de identificación único, que se utiliza para asociar campos de inventario del equipo con métricas.

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

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

Comportamiento de la propiedad:
- solo lectura