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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| 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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô 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 Áú»¢¶Ä²©; 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 Áú»¢¶Ä²©, 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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | 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 | ±«²ú¾±³¦²¹³¦¾±¨®²Ô. | 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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| 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) |