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

Comportamiento de la propiedad:
- 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.

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 proxy.
proxyid ID ID del proxy que se utiliza para monitorizar el host.

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

Comportamiento de la propiedad:
- obligatorio si monitored_by está establecido en "Grupo de proxy"
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 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
- 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.

Comportamiento de la propiedad:
- 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.

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 proxy.

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. Depende de la base de datos utilizada:
- 65535 caracteres para bases de datos SQL
- 2048 caracteres para bases de datos Oracle
32 contract_number string Número de contrato. 64 caracteres
47 date_hw_decomm string Fecha de baja del HW. 64 caracteres
46 date_hw_expiry string Fecha de vencimiento del mantenimiento del HW. 64 caracteres
45 date_hw_install string Fecha de instalación del HW. 64 caracteres
44 date_hw_purchase string Fecha de compra del HW. 64 caracteres
34 deployment_status string Estado de despliegue. 64 caracteres
14 hardware string 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 string Máscara de subred del host. 39 caracteres
38 host_networks string Redes del 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 string Router del host. 39 caracteres
30 hw_arch string Arquitectura HW. 32 caracteres
33 installer_name string Nombre del instalador. 64 caracteres
24 location string 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 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. Depende de la base de datos utilizada:
- 65535 caracteres para bases de datos SQL
- 2048 caracteres para bases de datos Oracle
41 oob_ip string Dirección IP OOB. 39 caracteres
42 oob_netmask string Máscara de subred OOB del host. 39 caracteres
43 oob_router string Router OOB. 39 caracteres
5 os string Nombre del SO. 128 caracteres
6 os_full string Nombre detallado del SO. 255 caracteres
7 os_short string Nombre corto del SO. 128 caracteres
61 poc_1_cell string Número móvil del POC principal. 64 caracteres
58 poc_1_email string Email principal. 128 caracteres
57 poc_1_name string Nombre del POC principal. 128 caracteres
63 poc_1_notes string Notas del POC principal. 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 string Teléfono A del POC principal. 64 caracteres
60 poc_1_phone_b string Teléfono B del POC principal. 64 caracteres
62 poc_1_screen string Nombre de pantalla del POC principal. 64 caracteres
68 poc_2_cell string Número móvil del POC secundario. 64 caracteres
65 poc_2_email string Email 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. 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 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. Depende de la base de datos utilizada:
- 65535 caracteres para bases de datos SQL
- 2048 caracteres para bases de datos Oracle
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. Depende de la base de datos utilizada:
- 65535 caracteres para bases de datos SQL
- 2048 caracteres para bases de datos Oracle
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.
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