Objeto equipo

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

Host

El objeto host tiene las siguientes propiedades.

Property Type Description
hostid ID ID del host.

Property behavior:
- solo lectura
- obligatorio para operaciones de actualización
host string Nombre técnico del host.

Property behavior:
- obligatorio 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 descubierto.

Property behavior:
- 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 IPMI.
ipmi_privilege integer Nivel de privilegio IPMI.

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

Property behavior:
- solo lectura
maintenance_status integer Estado del mantenimiento efectivo.

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

Property behavior:
- 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.

Property behavior:
- solo lectura
maintenanceid ID ID del mantenimiento que está actualmente en efecto en el host.

Property behavior:
- solo lectura
name string Nombre visible del host.

Predeterminado: valor de la propiedad host.
monitored_by integer Origen que se usa para supervisar el host.

Valores posibles:
0 - (predeterminado) Zabbix server;
1 - proxy;
2 - grupo de proxy.
proxyid ID ID del proxy que se usa para supervisar el host.

Property behavior:
- obligatorio si monitored_by está establecido en "Proxy"
proxy_groupid ID ID del grupo de proxy que se usa para supervisar el host.

Property behavior:
- obligatorio 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 posibles de bit:
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 bit 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 PSK; debe emparejarse con solo una PSK (entre autoregistration, hosts y proxies).

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

Property behavior:
- solo escritura
- obligatorio 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.

Property behavior:
- solo escritura
- obligatorio 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.

Property behavior:
- solo lectura
assigned_proxyid ID ID del proxy asignado por Zabbix server, si el host es supervisado por un grupo de proxy.

Property behavior:
- 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle databases
39 host_netmask string Máscara de subred del host. 39 characters
38 host_networks string Redes del host. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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 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. Depends on the database used:
- 65535 characters for SQL databases
- 2048 characters for Oracle 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