Documentation
Table of Contents
> Objeto de host
Los siguientes objetos están directamente relacionados con la API del host.
Equipo
El objeto host tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| hostid | cadena | (readonly) ID del equipo. |
| host (obligatorio) |
cadena | Nombre técnico del equipo. |
| description | texto | Descripción del equipo. |
| flags | entero | (readonly) Origen del equipo. Valores posibles: 0 - un equipo simple; 4 - un equipo descubierto. |
| inventory_mode | entero | Modo de llenado del inventario del equipo. Los valores posibles son: -1 - (predeterminado) deshabilitado; 0 - manual; 1 - automático. |
| ipmi_authtype | entero | algoritmo de autenticación de IPMI. Los valores posibles son: -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. Los valores posibles son: 1 - devolución de llamada; 2 - (predeterminado) usuario; 3 - operador; 4 - administrador; 5 - OEM. |
| ipmi_username | cadena | nombre de usuario de IPMI. |
| maintenance_from | timestamp | (solo lectura) Hora de inicio del mantenimiento efectivo. |
| maintenance_status | integer | (readonly) Estado de mantenimiento vigente. Los valores posibles son: 0 - (predeterminado) sin mantenimiento; 1 - mantenimiento vigente. |
| maintenance_type | entero | (readonly) Tipo de mantenimiento vigente. Los valores posibles son: 0 - (predeterminado) mantenimiento con recopilación de datos; 1 - mantenimiento sin recopilación de datos. |
| maintenanceid | cadena | (readonly) ID del mantenimiento que está vigente actualmente en el equipo. |
| name | cadena | Nombre visible del host. Valor predeterminado: valor de la propiedad host. |
| proxy_hostid | cadena | ID del proxy que se utiliza para supervisar el equipo. |
| status | entero | Estado y función del equipo. Los valores posibles son: 0 - (predeterminado) equipo monitoreado; 1 - equipo no monitoreado. |
| tls_connect | entero | Conexiones al equipo. Los valores posibles son: 1 - (predeterminado) Sin cifrado; 2 - PSK; 4 - certificado. |
| tls_accept | entero | Conexiones desde el equipo. Los valores de mapa de bits posibles son: 1 - (predeterminado) Sin cifrado; 2 - PSK; 4 - certificado. |
| tls_issuer | cadena | Emisor del certificado. |
| tls_subject | cadena | Asunto del certificado. |
| tls_psk_identity | cadena | (solo escritura) Identidad PSK; debe estar emparejado con un solo PSK (en autoregistration, hosts y proxies). Obligatorio si tls_connect o tls_accept tienen PSK habilitado.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. |
| tls_psk | cadena | (solo escritura) Clave precompartida (PSK); debe tener al menos 32 dígitos hexadecimales. Obligatorio si tls_connect o tls_accept tienen PSK habilitado. |
Tenga en cuenta que para algunos métodos (actualizar, eliminar) la combinación de parámetros obligatorios/opcionales es diferente.
Inventario de host
El objeto de inventario del host tiene las siguientes propiedades.
Cada propiedad tiene su propio número de identificación único, que se utiliza para asociar campos de inventario del host con items.
| ID | Propiedad | Tipo | Descripción | Longitud máxima |
|---|---|---|---|---|
| 4 | alias | cadena | Alias. | 128 caracteres |
| 11 | asset_tag | cadena | Etiqueta de activo. | 64 caracteres |
| 28 | chasis | cadena | Chasis. | 64 caracteres |
| 23 | contacto | 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 | contrato_número | cadena | Número de contrato. | 64 caracteres |
| 47 | date_hw_decomm | cadena | Fecha de desmantelamiento del HW. | 64 caracteres |
| 46 | fecha_hw_expiry | cadena | Fecha de caducidad del mantenimiento del HW. | 64 caracteres |
| 45 | fecha_hw_install | cadena | Fecha de instalación del HW. | 64 caracteres |
| 44 | fecha_hw_purchase | cadena | Fecha de compra de HW. | 64 caracteres |
| 34 | implementación_status | cadena | Estado de implementación. | 64 caracteres |
| 14 | hardware | cadena | Hardware. | 255 caracteres |
| 15 | hardware_full | cadena | 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 | Router de host. | 39 caracteres |
| 30 | hw_arch | cadena | Arquitectura HW. | 32 caracteres |
| 33 | instalador_nombre | cadena | Nombre del instalador. | 64 caracteres |
| 24 | ubicación | 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 | ubicación_lat | cadena | Latitud de ubicación. | 16 caracteres |
| 26 | ubicación_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 | modelo | cadena | Modelo. | 64 caracteres |
| 3 | nombre | cadena | Nombre. | 128 caracteres |
| 27 | notas | 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 | router 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 | cadena | Número de móvil POC principal. | 64 caracteres |
| 58 | poc_1_email | cadena | 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 | cadena | Nombre de pantalla de POC principal. | 64 caracteres |
| 68 | poc_2_cell | cadena | Número de móvil POC secundario. | 64 caracteres |
| 65 | poc_2_email | cadena | 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 | cadena | Teléfono POC secundario A. | 64 caracteres |
| 67 | poc_2_phone_b | cadena | Teléfono POC secundario B. | 64 caracteres |
| 69 | poc_2_screen | cadena | 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 | sitio_dirección_a | cadena | Dirección del sitio A. | 128 caracteres |
| 49 | sitio_dirección_b | cadena | Dirección del sitio B. | 128 caracteres |
| 50 | sitio_dirección_c | cadena | Dirección del sitio C. | 128 caracteres |
| 51 | sitio_ciudad | cadena | Ciudad del sitio. | 128 caracteres |
| 53 | sitio_país | 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 | cadena | 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 | etiqueta | cadena | Etiqueta. | 64 caracteres |
| 1 | tipo | cadena | Tipo. | 64 caracteres |
| 2 | type_full | cadena | Escriba detalles. | 64 caracteres |
| 35 | url_a | cadena | URL A. | 255 caracteres |
| 36 | url_b | cadena | URL B. | 255 caracteres |
| 37 | url_c | cadena | URL C. | 255 caracteres |
| 31 | proveedor | cadena | Proveedor. | 64 caracteres |
Etiqueta de host
El objeto de etiqueta de host tiene las siguientes propiedades.
| Propiedad | Tipo | Descripción |
|---|---|---|
| etiqueta (obligatorio) |
cadena | Nombre de etiqueta de host. |
| valor | cadena | Valor de etiqueta de host. |