Documentation
Table of Contents
Objeto de equipo
Los siguientes objetos están directamente relacionados con la API host.
Equipo
El objeto host tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| hostid | ID | ID del equipo. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualización |
| host | cadena | Nombre técnico del equipo. Comportamiento de la propiedad: - obligatorio para operaciones de creación |
| description | texto | Descripción del equipo. |
| flags | entero | Origen del equipo. Valores posibles: 0: un equipo normal; 4: un equipo descubierto. Comportamiento de la propiedad: - solo lectura |
| inventory_mode | entero | Modo de llenado del inventario del equipo. Valores posibles: -1: (predeterminado) deshabilitado; 0: manual; 1: automático. |
| ipmi_authtype | entero | Algoritmo de autenticación de IPMI. Valores posibles: -1: (predeterminado) predeterminado; 0: ninguno; 1: MD2; 2: MD5 4: directo; 5: OEM; 6: RMCP+. |
| ipmi_password | cadena | Contraseña de IPMI. |
| ipmi_privilege | entero | Nivel de privilegio de IPMI. Valores posibles: 1 - devolución de llamada; 2 - usuario (predeterminado); 3 - operador; 4 - administrador; 5 - OEM. |
| ipmi_username | cadena | Nombre de usuario de IPMI. |
| maintenance_from | timestamp | Hora de inicio del mantenimiento efectivo. Comportamiento de la propiedad: - solo lectura |
| maintenance_status | entero | Estado de mantenimiento vigente. Valores posibles: 0 - (predeterminado) sin mantenimiento; 1 - mantenimiento vigente. Comportamiento de la propiedad: - solo lectura |
| maintenance_type | entero | Tipo de mantenimiento vigente. Valores posibles: 0 - (predeterminado) mantenimiento con recopilación de datos; 1 - mantenimiento sin recopilación de datos. Comportamiento de la propiedad: - solo lectura |
| maintenanceid | ID | ID del mantenimiento que está actualmente en vigencia en el equipo. Comportamiento de la propiedad: - solo lectura |
| name | cadena | Nombre visible del equipo. Valor predeterminado: valor de la propiedad host. |
| monitored_by | entero | Origen que se utiliza para monitorear el equipo. Valores posibles: 0 - (predeterminado) servidor Zabbix; 1 - Proxy; 2 - Grupo de proxy. |
| proxyid | ID | ID del proxy que se utiliza para monitorear el equipo. Comportamiento de la propiedad: - obligatorio si monitored_by está configurado como "Proxy" |
| proxy_groupid | ID | ID del grupo de proxy que se utiliza para supervisar el equipo. Comportamiento de la propiedad: - obligatorio si monitored_by está configurado como "Grupo de proxy" |
| status | entero | Estado y función del host. Valores posibles: 0 - (predeterminado) equipo supervisado; 1 - equipo no supervisado. |
| tls_connect | entero | Conexiones al host. Valores posibles: 1 - (predeterminado) Sin cifrado; 2 - PSK; 4 - certificado. |
| tls_accept | entero | Conexiones desde el equipo. Este es un campo de máscara de bits, cualquier combinación de valores de mapa de bits posibles es aceptable. Posibles valores de mapa de bits: 1 - (predeterminado) Sin cifrado; 2 - PSK; 4 - certificado. |
| tls_issuer | cadena | Emisor del certificado. |
| tls_subject | cadena | Asunto del certificado. |
| tls_psk_identity | cadena | Identidad PSK; debe estar emparejado con un solo PSK (en autoregistration, hosts y proxies). No incluya información confidencial en la identidad PSK, ya que se envía sin cifrar a través de la red para informar al receptor qué PSK utilizar. Comportamiento de la propiedad: - solo escritura - obligatorio si tls_connect está configurado en "PSK", o tls_accept contiene el bit "PSK" |
| tls_psk | cadena | Clave precompartida (PSK); debe tener al menos 32 dígitos hexadecimales. Comportamiento de la propiedad: - solo escritura - obligatorio si tls_connect está configurado en "PSK" o tls_accept contiene el bit "PSK" |
| active_available | entero | Estado de disponibilidad de la interfaz activa del equipo. Valores posibles: 0: se desconoce el estado de la interfaz; 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 monitoreado por un grupo de proxy. 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 equipo
El objeto de etiqueta de equipo tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| tag | cadena | Nombre de etiqueta de equipo. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor de etiqueta de equipo. |
| automatic | entero | Tipo de etiqueta de equipo. Valores posibles: 0 - (predeterminado) manual (etiqueta creada por el usuario); 1 - automático (etiqueta creada por el usuario de bajo nivel). descubrimiento) |