Table of Contents
Objeto equipo
Los siguientes objetos están directamente relacionados con la API de equipos.
Equipo
El objeto equipo tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| hostid | ID | ID del equipo. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización |
| host | string | Nombre técnico del equipo. Comportamiento de la propiedad: - requerido para operaciones de creación |
| description | text | Descripción del equipo. |
| flags | integer | Origen del equipo. Valores posibles: 0 - un equipo simple; 4 - un equipo convertido desde prototipo. Comportamiento de la propiedad: - solo lectura |
| inventory_mode | integer | Modo de población del inventario del equipo. 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 - directo; 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 equipo. Comportamiento de la propiedad: - solo lectura |
| name | string | Nombre visible del equipo. Por defecto: valor de la propiedad host. |
| monitored_by | integer | Fuente que se utiliza para monitorizar el equipo. Valores posibles: 0 - (por defecto) servidor Zabbix; 1 - Proxy; 2 - Grupo de proxies. |
| proxyid | ID | ID del proxy que se utiliza para monitorizar el equipo. 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 equipo. Comportamiento de la propiedad: - requerido si monitored_by está establecido en "Grupo de proxies" |
| status | integer | Estado y función del equipo. Valores posibles: 0 - (por defecto) habilitado; 1 - deshabilitado. |
| tls_connect | integer | Conexiones al equipo. Valores posibles: 1 - (por defecto) Sin cifrado; 2 - PSK; 4 - certificado. |
| tls_accept | integer | Conexiones desde el equipo. 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 una sola PSK (entre autoregistro, equipos 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. 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 equipo. 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 equipo es monitorizado por un grupo de proxies. Comportamiento de la propiedad: - solo lectura |
Inventario de equipos
El objeto de inventario de equipos tiene las siguientes propiedades.
Cada propiedad tiene su propio número de ID único, que se utiliza para asociar los campos de inventario de equipos con las métricas.
| 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 retirada del HW. | 64 caracteres |
| 46 | date_hw_expiry | string | Fecha de vencimiento del mantenimiento 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. | 65535 caracteres para bases de datos SQL |
| 39 | host_netmask | string | Máscara de subred del equipo. | 39 caracteres |
| 38 | host_networks | string | Redes del equipo. | 65535 caracteres para bases de datos SQL |
| 40 | host_router | string | Router del equipo. | 39 caracteres |
| 30 | hw_arch | string | Arquitectura HW. | 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 del equipo. | 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 POC principal. | 64 caracteres |
| 58 | poc_1_email | string | Correo electrónico principal. | 128 caracteres |
| 57 | poc_1_name | string | Nombre POC principal. | 128 caracteres |
| 63 | poc_1_notes | string | Notas POC principal. | 65535 caracteres para bases de datos SQL |
| 59 | poc_1_phone_a | string | Teléfono A POC principal. | 64 caracteres |
| 60 | poc_1_phone_b | string | Teléfono B POC principal. | 64 caracteres |
| 62 | poc_1_screen | string | Nombre de pantalla POC principal. | 64 caracteres |
| 68 | poc_2_cell | string | Número móvil POC secundario. | 64 caracteres |
| 65 | poc_2_email | string | Correo electrónico POC secundario. | 128 caracteres |
| 64 | poc_2_name | string | Nombre POC secundario. | 128 caracteres |
| 70 | poc_2_notes | string | Notas POC secundario. | 65535 caracteres para bases de datos SQL |
| 66 | poc_2_phone_a | string | Teléfono A POC secundario. | 64 caracteres |
| 67 | poc_2_phone_b | string | Teléfono B POC secundario. | 64 caracteres |
| 69 | poc_2_screen | string | Nombre de pantalla 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 | Fabricante. | 64 caracteres |
Etiqueta de equipo
El objeto de etiqueta de equipo tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | string | Nombre de la etiqueta de equipo. Comportamiento de la propiedad: - obligatorio |
| value | string | Valor de la etiqueta de equipo. |
| automatic | integer | Tipo de etiqueta de equipo. 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 |