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
- requerido para operaciones de actualización
host string Nombre técnico del host.

Comportamiento de la propiedad:
- requerido 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 desde una plantilla prototipo.

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

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

Valores posibles:
-1 - (por defecto) por defecto;
0 - ninguno;
1 - MD2;
2 - MD5
4 - straight;
5 - OEM;
6 - RMCP+.
ipmi_password string Contraseña IPMI.
ipmi_privilege integer 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 integer Estado de mantenimiento efectivo.

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

Comportamiento de la propiedad:
- solo lectura
maintenance_type integer 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 integer Fuente que se utiliza para monitorizar el host.

Valores posibles:
0 - (por defecto) Zabbix server;
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 integer Estado y función del host.

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

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

Valores posibles de bitmask:
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 una sola PSK (en 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 integer 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 Zabbix server, si el host es monitorizado por un grupo de proxies.

Comportamiento de la propiedad:
- solo lectura

Inventario del host

El objeto de inventario del host tiene las siguientes propiedades.

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

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

Etiqueta de host

El objeto de etiqueta de host tiene las siguientes propiedades.

Property Type Description
tag string Nombre de la etiqueta de host.

Property behavior:
- required
value string Valor de la etiqueta de host.
automatic integer Tipo de etiqueta de host.

Valores posibles:
0 - (default) manual (etiqueta creada por el usuario);
1 - automática (etiqueta creada por la detección de bajo nivel)

Property behavior:
- read-only