en-us	### Group prototype  The group prototype object defines a group that will be created for a discovered host. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Name of the group prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
es	### Prototipo de grupo  El objeto prototipo de grupo define un grupo que se creará para un equipo descubierto. Tiene las siguientes propiedades.  |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |name|cadena|Nombre del prototipo del grupo.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *requerido*|

en-us	#### - GUI  This section provides customization of several frontend-related defaults.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_gui.png)  Configuration parameters:  |Parameter|Description| |--|--------| |*Default language*|Default language for users who have not specified a language in their profiles and guest users.<br>For more information, see [Installation of additional frontend languages](/manual/appendix/install/locales).| |*Default time zone*|Default [time zone](/manual/web_interface/time_zone#overview) for users who have not specified a time zone in their profiles and guest users.| |*Default theme*|Default theme for users who have not specified a theme in their profiles and guest users.| |*Limit for search and filter results*|Maximum amount of elements (rows) that will be displayed in a web-interface list, for example, in *Data collection → Hosts*.<br>*Note*: If set to, for example, '50', only the first 50 elements will be displayed in all affected frontend lists. If some list contains more than fifty elements, the indication of that will be the '+' sign in *"Displaying 1 to 50 of **50+** found"*. Also, if filtering is used and still there are more than 50 matches, only the first 50 will be displayed.| |*Max number of columns<br>and rows in overview tables*|Maximum number of columns and rows to display in Data overview and Trigger overview dashboard widgets. The same limit applies to both columns and rows. If more rows and/or columns than shown exist, the system will display a warning at the bottom of the table: "Not all results are displayed. Please provide more specific search criteria."| |*Max count of elements<br>to show inside table cell*|For entries that are displayed in a single table cell, no more than configured here will be shown.| |*Show warning if Zabbix server is down*|This parameter enables a warning message to be displayed in a browser window if the Zabbix server cannot be reached (possibly down). The message remains visible even if the user scrolls down the page. When hovered over, the message is temporarily hidden to reveal the contents underneath it.| |*Working time*|This system-wide parameter defines working hours. In graphs, working time is displayed as a white background and non-working time is displayed as gray.<br>See [Time period specification](/manual/appendix/time_period) page for description of the time format.<br>[User macros](/manual/config/macros/user_macros) are supported.| |*Show technical errors*|If checked, all registered users will be able to see technical errors (PHP/SQL). If unchecked, the information is only available to [Zabbix Super Admins](/manual/web_interface/frontend_sections/users/users#users1) and users belonging to the user groups with enabled [debug mode](/manual/web_interface/debug_mode).| |*Max history display period*|Maximum time period for which to display historical data in *Monitoring* subsections: *Latest data*, *Web*, and in the *Data overview* dashboard widget.<br>Allowed range: 24 hours (default) - 1 week. [Time suffixes](/manual/appendix/suffixes), e.g. 1w (one week), 36h (36 hours), are supported.| |*Time filter default period*|Time period to be used in graphs and dashboards by default. Allowed range: 1 minute - 10 years (default: 1 hour).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 10m (ten minutes), 5w (five weeks), are supported.<br>Note: when a user changes the time period while viewing a graph, this time period is stored as user preference, replacing the global default or a previous user selection.| |*Max period for time selector*|Maximum available time period for graphs and dashboards. Users will not be able to visualize older data. Allowed range: 1 year - 10 years (default: 2 years).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 1y (one year), 365w (365 weeks), are supported.|
es	#### - GUI  Esta sección proporciona personalización de varios aspectos relacionados con los valores predeterminados de la interfaz.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_gui.png)  Parámetros de configuración:  |Parámetro|Descripción| |--|--------| |*Idioma predeterminado*|Idioma predeterminado para usuarios que no han especificado un idioma en sus perfiles y usuarios invitados.<br>Para obtener más información, consulte [Instalación de idiomas de interfaz adicionales](/manual/appendix/install/locales).| |*Zona horaria predeterminada*|[zona horaria](/manual/web_interface/time_zone#overview) predeterminada para los usuarios que no han especificado una zona horaria en sus perfiles y los usuarios invitados.| |*Tema predeterminado*|Tema predeterminado para los usuarios que no han especificado un tema en sus perfiles y los usuarios invitados.| |*Límite de resultados de búsqueda y filtrado*|Cantidad máxima de elementos (filas) que se mostrarán en una lista de interfaz web, por ejemplo, en *Recopilación de datos → Equipos*.<br>*Nota*: Si se establece en, por ejemplo, '50', solo se mostrarán los primeros 50 elementos en todas las listas de frontend afectadas. Si alguna lista contiene más de cincuenta elementos, la indicación de ello será el signo '+' en *"Mostrando 1 a 50 de **50+** encontrados"*. Además, si se utiliza el filtrado y todavía hay más de 50 coincidencias, sólo se mostrarán las primeras 50.| |*Número máximo de columnas<br>y filas en tablas de descripción general*|Número máximo de columnas y filas para mostrar en los widgets del panel de descripción general de datos y descripción general de iniciadores. El mismo límite se aplica tanto a las columnas como a las filas. Si existen más filas y/o columnas de las que se muestran, el sistema mostrará una advertencia en la parte inferior de la tabla: "No se muestran todos los resultados. Proporcione criterios de búsqueda más específicos".| |*Recuento máximo de elementos<br>para mostrar dentro de la celda de la tabla*|Para las entradas que se muestran en una sola celda de la tabla, no se mostrarán más de los configurados aquí.| |*Mostrar advertencia si el servidor Zabbix está inactivo*|Este parámetro permite que se muestre un mensaje de advertencia en una ventana del navegador si no se puede acceder al servidor Zabbix (posiblemente inactivo). El mensaje permanece visible incluso si el usuario se desplaza hacia abajo en la página. Cuando se coloca el cursor sobre él, el mensaje se oculta temporalmente para revelar el contenido que se encuentra debajo.| |*Tiempo de trabajo*|Este parámetro de todo el sistema define las horas de trabajo. En los gráficos, el tiempo de trabajo se muestra sobre un fondo blanco y el tiempo no laborable se muestra en gris.<br>Consulte la página [Especificación del período de tiempo](/manual/appendix/time_period) para obtener una descripción del formato de hora.<br>[Se admiten macros de usuario](/manual/config/macros/user_macros).| |*Mostrar errores técnicos*|Si está marcado, todos los usuarios registrados podrán ver los errores técnicos (PHP/SQL). Si no está marcada, la información solo está disponible para los [superadministradores de Zabbix](/manual/web_interface/frontend_sections/users/users#users1) y los usuarios que pertenecen a los grupos de usuarios con el [modo de depuración](/manual/web_interface/debug_mode) habilitado. | |*Período máximo de visualización del historial*|Período de tiempo máximo para mostrar datos históricos en las subsecciones *Monitoreo*: *Últimos datos*, *Web* y en el widget del tablero *Resumen de datos*.<br>Rango permitido: 24 horas (predeterminado) - 1 semana. [Sufijos de tiempo](/manual/apéndice/sufijos), p.e. Se admiten 1 semana (una semana), 36 h (36 horas).| |*Período predeterminado del filtro de tiempo*|Período de tiempo que se utilizará en gráficos y tableros de forma predeterminada. Rango permitido: 1 minuto - 10 años (predeterminado: 1 hora).<br>[Sufijos de tiempo](/manual/appendix/suffixes), p.e. Se admiten 10 m (diez minutos) y 5 semanas (cinco semanas).<br>Nota: cuando un usuario cambia el período de tiempo mientras visualiza un gráfico, este período de tiempo se almacena como preferencia del usuario, reemplazando el valor predeterminado global o una selección anterior del usuario. .| |*Período máximo para el selector de tiempo*|Período de tiempo máximo disponible para gráficos y tableros. Los usuarios no podrán visualizar datos más antiguos. Rango permitido: 1 año - 10 años (predeterminado: 2 años).<br>[Sufijos de tiempo](/manual/appendix/suffixes), p.e. Se admiten 1y (un año), 365w (365 semanas).|

en-us	 #### Handling of regular expression compilation and runtime errors  If a regular expression used in `log[]`, `logrt[]`, `log.count[]` or `logrt.count[]` item cannot be compiled by PCRE or PCRE2 library then the item goes into  NOTSUPPORTED state with an error message. To continue monitoring the log item, the regular expression should be fixed.  If the regular expression compiles successfully, but fails at runtime (on some or on all log records), then the log item remains supported and  monitoring continues. The runtime error is logged in the Zabbix agent log file (without the log file record).   The logging rate is limited to one runtime error per check to allow Zabbix agent to monitor its own log file.  For example, if 10 records are analyzed and 3 records fail with a regexp runtime error, one record is produced in the agent log.   Exception: if MaxLinesPerSecond=1 and update interval=1 (only 1 record is allowed to analyze per check) then regexp runtime errors are not logged.  zabbix_agentd logs the item key in case of a runtime error, zabbix_agent2 logs the item ID to help identify which log item has runtime errors.  It is recommended to redesign the regular expression in case of runtime errors.
es	 #### Manejo de errores de compilación y tiempo de ejecución de expresiones regulares  Si una expresión regular utilizada en el elemento `log[]`, `logrt[]`, `log.count[]` o `logrt.count[]` no puede ser compilada por la biblioteca PCRE o PCRE2, entonces el elemento entra en  Estado NOTSUPPORTED con un mensaje de error. Para continuar monitoreando el elemento de registro, se debe corregir la expresión regular.  Si la expresión regular se compila correctamente, pero falla en tiempo de ejecución (en algunos o en todos los registros), entonces el elemento de registro sigue siendo compatible y  el seguimiento continúa. El error de tiempo de ejecución se registra en el archivo de registro del agente Zabbix (sin el registro del archivo de registro).   La tasa de registro está limitada a un error de tiempo de ejecución por verificación para permitir que el agente Zabbix supervise su propio archivo de registro.  Por ejemplo, si se analizan 10 registros y 3 registros fallan con un error de tiempo de ejecución de expresión regular, se genera un registro en el registro del agente.   Excepción: si MaxLinesPerSecond=1 y el intervalo de actualización=1 (solo se permite analizar 1 registro por verificación), los errores de tiempo de ejecución de expresiones regulares no se registran.  zabbix_agentd registra la clave del elemento en caso de un error de tiempo de ejecución, zabbix_agent2 registra el ID del elemento para ayudar a identificar qué elemento de registro tiene errores de tiempo de ejecución.  Se recomienda rediseñar la expresión regular en caso de errores de tiempo de ejecución.

en-us	# hanode.get
es	# hanode.get

en-us	##### HANodeName The high availability cluster node name. When empty the server is working in standalone mode and a node with empty name is created.
es	##### HANodeName El nombre del nodo del clúster de alta disponibilidad. Cuando está vacío, el servidor funciona en modo independiente y se crea un nodo con un nombre vacío.

en-us	 #### Hardening security of Zabbix components  Some functionality can be switched off to harden the security of Zabbix components:  -    global script execution on Zabbix server can be disabled by setting EnableGlobalScripts=0 in server configuration; -    global script execution on Zabbix proxy is disabled by default (can be enabled by setting EnableRemoteCommands=1 in proxy configuration); -    global script execution on Zabbix agents is disabled by default (can be enabled by adding an AllowKey=system.run[<command>,\*] parameter for each allowed command in agent configuration); -    user HTTP authentication can be disabled by setting `$ALLOW_HTTP_AUTH=false` in the frontend configuration file (zabbix.conf.php). Note that reinstalling the frontend (running setup.php) will remove this parameter.
es	 #### Refuerzo de la seguridad de los componentes de Zabbix  Algunas funciones se pueden desactivar para reforzar la seguridad de los componentes de Zabbix:  -   La ejecución global de scripts en el servidor Zabbix se puede deshabilitar configurando EnableGlobalScripts=0 en la configuración del servidor; -   La ejecución de script global en el proxy Zabbix está deshabilitada de forma predeterminada (se puede habilitar estableciendo EnableRemoteCommands=1 en la configuración del proxy); -   La ejecución de script global en agentes Zabbix está deshabilitada de forma predeterminada (se puede habilitar agregando un parámetro AllowKey=system.run[<command>,\*] para cada comando permitido en la configuración del agente); -   La autenticación HTTP del usuario se puede desactivar configurando `$ALLOW_HTTP_AUTH=false` en el archivo de configuración de la interfaz (zabbix.conf.php). Tenga en cuenta que reinstalar la interfaz (ejecutando setup.php) eliminará este parámetro.

en-us	#### Hardware
es	#### Hardware

en-us	 **ha\_remove\_node**\[=*target*\]   Remove the high availability (HA) node specified by its name or ID. Note that active/standby nodes cannot be removed.  **ha\_set\_failover\_delay**\[=*delay*\]   Set high availability (HA) failover delay. Time suffixes are supported, e.g. 10s, 1m.  **proxy\_config\_cache\_reload**\[=*target*\] Reload proxy configuration cache.  **secrets\_reload**   Reload secrets from Vault.  **service\_cache\_reload**   Reload the service manager cache.  **prof\_enable**\[=*target*\]   Enable profiling. Affects all processes if target is not specified. Enabled profiling provides details of all rwlocks/mutexes by function name. Supported since Zabbix 6.0.13.  **prof\_disable**\[=*target*\]   Disable profiling. Affects all processes if target is not specified. Supported since Zabbix 6.0.13.    **log\_level\_increase**\[=*target*\]   Increase log level, affects all processes if target is not specified     **log\_level\_decrease**\[=*target*\]   Decrease log level, affects all processes if target is not specified  [ ]{#lbAG}
es	 **ha\_remove\_node**\[=*target*\] Elimine el nodo de alta disponibilidad (HA) especificado por su nombre o ID. Tenga en cuenta que los nodos activos/en espera no se pueden eliminar.  **ha\_set\_failover\_delay**\[=*delay*\] Establezca un retraso de conmutación por error de alta disponibilidad (HA). Se admiten sufijos de tiempo, p.e. 10s, 1m.  **secrets\_reload** Recargar secretos de Vault.  **service\_cache\_reload** Vuelva a cargar la caché del administrador de servicios.  **snmp\_cache\_reload** Vuelva a cargar la caché SNMP, borre las propiedades SNMP (hora del motor, arranque del motor, identificación del motor, credenciales) para todos los equipos.  **prof\_enable**\[=*target*\] Habilitar la creación de perfiles. Afecta a todos los procesos si no se especifica el objetivo. La creación de perfiles habilitada proporciona detalles de todos los rwlocks/mutex por nombre de función. Compatible desde Zabbix 6.0.13.  **prof\_disable**\[=*target*\] Deshabilitar la creación de perfiles. Afecta a todos los procesos si no se especifica el objetivo. Compatible desde Zabbix 6.0.13.  **log\_level\_increase**\[=*target*\] Aumentar el nivel de registro, afecta a todos los procesos si no se especifica el objetivo     **log\_level\_decrease**\[=*target*\] Disminuir el nivel de registro, afecta a todos los procesos si no se especifica el objetivo  [ ]{#lbAG}

en-us	##### - HDD/flash image (raw)      dd if=./zabbix_appliance_7.0.0.raw of=/dev/sdc bs=4k conv=fdatasync  Replace */dev/sdc* with your Flash/HDD disk device.
es	##### - Imagen HDD/flash (sin procesar)      dd if=./zabbix_appliance_7.0.0.raw of=/dev/sdc bs=4k conv=fdatasync  Reemplace */dev/sdc* con su dispositivo de disco Flash/HDD.

en-us	#### Header processing  The CSV file header line can be processed in two different ways:  -   If the *With header row* checkbox is marked - header line values are     interpreted as column names. In this case the column names must be     unique and the data row should not contain more columns than the     header row. -   If the *With header row* checkbox is not marked - the header line is     interpreted as data. Column names are generated automatically     (1,2,3,4...).  CSV file example:      Nr,Item name,Key,Qty     1,active agent item,agent.hostname,33     "2","passive agent item","agent.version","44"     3,"active,passive agent items",agent.ping,55  ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. :::  **Processing header line**  JSON output when a header line is expected:  ``` {.json} [    {       "Nr":"1",       "Item name":"active agent item",       "Key":"agent.hostname",       "Qty":"33"    },    {       "Nr":"2",       "Item name":"passive agent item",       "Key":"agent.version",       "Qty":"44"    },    {       "Nr":"3",       "Item name":"active,passive agent items",       "Key":"agent.ping",       "Qty":"55"    } ] ```  **No header line processing**  JSON output when a header line is not expected:  ``` {.json} [    {       "1":"Nr",       "2":"Item name",       "3":"Key"       "4":"Qty"    },    {       "1":"1",       "2":"active agent item",       "3":"agent.hostname"       "4":"33"    },    {       "1":"2",       "2":"passive agent item",       "3":"agent.version"       "4":"44"    },    {       "1":"3",       "2":"active,passive agent items",       "3":"agent.ping"       "4":"55"    } ] ```
es	#### Procesamiento de encabezado  La línea de encabezado del archivo CSV se puede procesar de dos maneras diferentes:  - Si la casilla de verificación *Con fila de encabezado* está marcada, los valores de la línea de encabezado son     interpretados como nombres de columnas. En este caso los nombres de las columnas deben ser     únicos y la fila de datos no debe contener más columnas que la     fila de encabezado; - Si la casilla de verificación *Con fila de encabezado* no está marcada, la línea de encabezado es     interpretada como datos. Los nombres de las columnas se generan automáticamente     (1,2,3,4...)  Ejemplo de archivo CSV:      Nr, nombre del artículo, clave, cantidad     1, elemento de agente activo, agente.nombre de host, 33     "2","elemento de agente pasivo","agent.version","44"     3, "elementos de agente activo y pasivo", agente.ping, 55  ::: noteclassic Un carácter de comilla dentro de un campo entre comillas en la entrada debe escaparse precediéndolo de otra comilla. :::  **Línea de encabezado de procesamiento**  Salida JSON cuando se espera una línea de encabezado:  ``` {.json} [    {       "Nr":"1",       "Item name":"active agent item",       "Key":"agent.hostname",       "Qty":"33"    },    {       "Nr":"2",       "Item name":"passive agent item",       "Key":"agent.version",       "Qty":"44"    },    {       "Nr":"3",       "Item name":"active,passive agent items",       "Key":"agent.ping",       "Qty":"55"    } ] ```  **No header line processing**  JSON output when a header line is not expected:  ``` {.json} [    {       "1":"Nr",       "2":"Item name",       "3":"Key"       "4":"Qty"    },    {       "1":"1",       "2":"active agent item",       "3":"agent.hostname"       "4":"33"    },    {       "1":"2",       "2":"passive agent item",       "3":"agent.version"       "4":"44"    },    {       "1":"3",       "2":"active,passive agent items",       "3":"agent.ping"       "4":"55"    } ] ```

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
es	##### HeartbeatFrequency  La frecuencia de los mensajes de latidos del corazón en segundos. Se utiliza para monitorear la disponibilidad de comprobaciones activas.<br>0: mensajes de latido deshabilitados.  Predeterminado: `60`<br> Rango: 0-3600

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
es	##### HeartbeatFrequency  La frecuencia de los mensajes de latidos del corazón en segundos. Se utiliza para monitorear la disponibilidad de comprobaciones activas.<br>0: mensajes de latido deshabilitados.  Predeterminado: `60`<br> Rango: 0-3600

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
es	##### HeartbeatFrequency  La frecuencia de los mensajes de latidos del corazón en segundos. Se utiliza para monitorear la disponibilidad de comprobaciones activas.<br>0: mensajes de latido deshabilitados.  Predeterminado: `60`<br> Rango: 0-3600

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
es	##### HeartbeatFrequency  La frecuencia de los mensajes de latidos del corazón en segundos. Se utiliza para monitorear la disponibilidad de comprobaciones activas.<br>0: mensajes de latido deshabilitados.  Predeterminado: `60`<br> Rango: 0-3600

en-us	 ##### Heartbeat message  The heartbeat message is sent by an active agent to Zabbix server/proxy  every HeartbeatFrequency seconds (configured in the [Zabbix agent](/manual/appendix/config/zabbix_agentd)/ [agent 2](/manual/appendix/config/zabbix_agent2) configuration file).  It is used to monitor the availability of active checks.  ```json {   "request": "active check heartbeat",   "host": "Zabbix server",   "heartbeat_freq": 60,   "version": "7.0.0",   "variant": 2 } ```  | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active check heartbeat` | | host | _string_ | yes | The host name. | | heartbeat_freq | _number_ | yes | The agent heartbeat frequency (HeartbeatFrequency configuration parameter). | | version | _string_ | yes | The agent version number. | | variant | _number_ | yes | The agent variant (*1* - Zabbix agent, *2* - Zabbix agent 2). |
es	 ##### Mensaje de latido  El mensaje de latido es enviado por un agente activo al servidor/proxy de Zabbix.  cada segundo de HeartbeatFrequency (configurado en el [agente Zabbix](/manual/appendix/config/zabbix_agentd)/ [agente 2](/manual/appendix/config/zabbix_agent2) archivo de configuración).  Se utiliza para monitorear la disponibilidad de cheques activos.  ```json {   "solicitud": "comprobación activa del latido del corazón",   "host": "servidor Zabbix",   "frecuencia_latidos": 60,   "versión": "7.0.0",   "variante": 2 } ```  | Campo | Tipo | Obligatorio | Valor | |-|-|-|--------| | solicitud | _cadena_ | si | `comprobación activa del latido del corazón` | | anfitrión | _cadena_ | si | El nombre del host. | | frecuencia_latidos | _número_ | si | La frecuencia de latido del agente (parámetro de configuración HeartbeatFrequency). | | versión | _cadena_ | si | El número de versión del agente. | | variante | _número_ | si | La variante del agente (*1* - agente Zabbix, *2* - agente Zabbix 2). |

en-us	 ##### Hexadecimal to decimal {#hexadecimal}  Convert the value from hexadecimal format to decimal.  If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected.
es	 ##### Hexadecimal a decimal {#hexadecimal}  Convierta el valor del formato hexadecimal a decimal.  Si marca la casilla de verificación *Personalizado en caso de error*, es posible especificar opciones personalizadas de manejo de errores: descartar el valor, establecer un valor específico o establecer un mensaje de error específico. En caso de que falle un paso de preprocesamiento, la métrica no dejará de ser compatible si se selecciona la opción de descartar el valor o establecer un valor específico.

en-us	##### Hidden menu  Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon ![](../../../assets/en/manual/web_interface/burger_icon.png){class="nozoom"}. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button.
es	##### Menú oculto  Incluso cuando el menú está completamente oculto, un menú completo está a solo un clic de ratón , haciendo clic en el ícono de la hamburguesa![](../../../assets/en/manual/web_interface/burger_icon.png){class="nozoom"}. Tenga en cuenta que reaparece sobre el contenido de la página; Para mover el contenido de la página hacia la derecha, debe mostrar el menú haciendo clic en el botón Mostrar barra lateral.

en-us	#### Hiding the file with list of common passwords  To increase the complexity of password brute force attacks, limiting access to the `ui/data/top_passwords.txt` file is recommended. This file contains a list of the most common and context-specific passwords and prevents users from setting such passwords (if the *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/users/authentication#internal_authentication)).  To limit access to the `top_passwords.txt` file, modify your web server configuration.  On Apache, file access can be limited using the `.htaccess` file:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```  On NGINX, file access can be limited using the `location` directive:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```
es	#### Ocultar el archivo con la lista de contraseñas comunes  Para aumentar la complejidad de los ataques de fuerza bruta a contraseñas, se recomienda limitar el acceso al archivo `ui/data/top_passwords.txt`. Este archivo contiene una lista de las contraseñas más comunes y específicas del contexto y evita que los usuarios establezcan dichas contraseñas (si el parámetro *Evitar contraseñas fáciles de adivinar* está habilitado en la [política de contraseñas](/manual/web_interface/frontend_sections/usuarios/autenticación#autenticación_interna)).  Para limitar el acceso al archivo `top_passwords.txt`, modifique la configuración de su servidor web.  En Apache, el acceso a los archivos se puede limitar utilizando el archivo `.htaccess`:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```  En NGINX, el acceso a archivos se puede limitar usando la directiva `ubicación`:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```

en-us	#### High availability cluster  Retrieve a list of server nodes and their status.  [High availability cluster API](/manual/api/reference/hanode)
es	#### Clúster de alta disponibilidad  Obtenga una lista de los nodos del clúster y su estado.  [API de Clúster de alta disponibilidad](/manual/api/reference/hanode)

en-us	### High availability node  ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. :::  The High availability node object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeid|ID|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, that is, time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.|
es	### Nodo de alta disponibilidad  ::: noteclassic Los nodos son creados por el servidor Zabbix y no pueden ser modificados a través de la API. :::  El objeto de nodo de alta disponibilidad tiene las siguientes propiedades.  |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |ha\_nodeid|ID|ID del nodo.| |name|cadena|Nombre asignado al nodo, utilizando la entrada de configuración HANodeName de zabbix\_server.conf. Vacío para un servidor que se ejecuta en modo independiente.| |address|cadena|IP o nombre DNS desde donde se conecta el nodo.| |port|entero|Puerto en el que se ejecuta el nodo.| |lastaccess|integer|Tiempo de latido, es decir, tiempo de la última actualización del nodo. Marca de tiempo UTC.| |status|entero|Estado del nodo.<br><br>Valores posibles:<br>0 - en espera;<br>1 - detenido manualmente;<br>2 - no disponible;<br>3 - activo.|

en-us	# High availability node object  The following object is related to operating a High availability cluster of Zabbix servers.
es	# Objeto de nodo de alta disponibilidad  El siguiente objeto está relacionado con el funcionamiento de un clúster de alta disponibilidad de servidores Zabbix.

en-us	#### High availability nodes  If [high availability cluster](/manual/concepts/server/ha) is enabled, then another block of data is displayed with the status of each high availability node.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Displayed data:  |Column|Description| |--|--------| |*Name*|Node name, as defined in server configuration.| |*Address*|Node IP address and port.| |*Last access*|Time of node last access.<br>Hovering over the cell shows the timestamp of last access in long format.| |*Status*|Node status:<br>**Active** - node is up and working<br>**Unavailable** - node hasn't been seen for more than failover delay (you may want to find out why)<br>**Stopped** - node has been stopped or couldn't start (you may want to start it or delete it)<br>**Standby** - node is up and waiting|
es	#### Nodos de alta disponibilidad  Si el [clúster de alta disponibilidad](/manual/concepts/server/ha) está habilitado, se muestra otro bloque de datos con el estado de cada nodo de alta disponibilidad.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Datos mostrados:  |Columna|Descripción| |--|--------| |*Nombre*|Nombre del nodo, tal como se define en la configuración del servidor.| |*Dirección*|Dirección IP y puerto del nodo.| |*Último acceso*|Hora del último acceso al nodo.<br>Al pasar el cursor sobre la celda se muestra la marca de tiempo del último acceso en formato largo.| |*Estado*|Estado del nodo:<br>**Activo**: el nodo está activo y funcionando<br>**No disponible**: el nodo no se ha visto durante más que un tiempo de espera en caso de error (es posible que desee saber por qué )<br>**Detenido**: el nodo se detuvo o no se pudo iniciar (es posible que desee iniciarlo o eliminarlo)<br>**En espera**: el nodo está activo y esperando|

en-us	# High availability node  This class is designed to work with server nodes that are part of a high availability cluster or a standalone server instance.  Object references:  -   [High availability node](/manual/api/reference/hanode/object#high_availability_node)  Available methods:  -   [hanode.get](/manual/api/reference/hanode/get) - retrieve nodes
es	# Nodo de alta disponibilidad  Esta clase está diseñada para funcionar con nodos de servidor que forman parte de un un clúster de alta disponibilidad o una instancia de servidor independiente.  Referencias de objetos:  -   [Nodo de alta disponibilidad](/manual/api/reference/hanode/object#hanode)  Métodos disponibles:  -   [hanode.get](/manual/api/reference/hanode/get) - recuperar nodos

en-us	 ##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile}  Calculates the φ-quantile from the buckets of a histogram.<br> Supported [foreach function](/manual/appendix/functions/aggregate/foreach): *bucket_rate_foreach*.  Parameters:   -   **quantile** - 0 ≤ φ ≤ 1;<br> -   **bucketN, valueN** - manually entered pairs (>=2) of parameters or the response of [bucket_rate_foreach](/manual/appendix/functions/aggregate/foreach).  Comments:  -   Supported only in calculated items; -   Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' of PromQL; -   Returns -1 if values of the last 'Infinity' bucket (*"+inf"*) are equal to 0.  Examples:      histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]))     histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s))
es	 ##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile}  Calcula el cuantil φ a partir de las agrupaciones de datos de un histograma.<br> [Función foreach](/manual/appendix/functions/aggregate/foreach) admitida: *bucket_rate_foreach*.  Parámetros:  - **cuantil** - 0 ≤ φ ≤ 1;<br> - **bucketN, valueN** - pares ingresados manualmente (>=2) de parámetros o la respuesta de [bucket_rate_foreach](/manual/appendix/functions/aggregate/foreach).  Comentarios:  - Compatible únicamente con métricas calculadas; - Funcionalmente corresponde a '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' de PromQL; - Devuelve -1 si los valores de la última agrupación de datos 'Infinito' (*"+inf"*) son iguales a 0.  Ejemplos:      histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]))     histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s))

en-us	##### HistoryCacheSize  The size of the history cache, in bytes. The shared memory size for storing history data.  Default: `16M`<br> Range: 128K-2G
es	##### HistoryCacheSize El tamaño de la caché del historial, en bytes. El tamaño de la memoria compartida para almacenar datos históricos.  Predeterminado: `16M`<br> Rango: 128K-2G

en-us	##### HistoryCacheSize The size of the history cache, in bytes. The shared memory size for storing history data.  Default: `16M`<br> Range: 128K-2G
es	##### HistoryCacheSize El tamaño de la caché del historial, en bytes. El tamaño de la memoria compartida para almacenar datos históricos.  Predeterminado: `16M`<br> Rango: 128K-2G

en-us	# history.clear
es	# history.clear

en-us	# history.get
es	# history.get

en-us	##### HistoryIndexCacheSize  The size of the history index cache, in bytes. The shared memory size for indexing the history data stored in history cache. The index cache size needs roughly 100 bytes to cache one item.  Default: `4M`<br> Range: 128K-2G
es	##### HistoryIndexCacheSize El tamaño de la caché del índice histórico, en bytes. El tamaño de la memoria compartida para indexar los datos del historial almacenados en la caché del historial. El tamaño de la caché de índice necesita aproximadamente 100 bytes para almacenar en caché un elemento.  Predeterminado: `4M`<br> Rango: 128K-2G

en-us	##### HistoryIndexCacheSize The size of the history index cache, in bytes. The shared memory size for indexing the history data stored in history cache. The index cache size needs roughly 100 bytes to cache one item.  Default: `4M`<br> Range: 128K-2G
es	##### HistoryIndexCacheSize El tamaño de la caché del índice histórico, en bytes. El tamaño de la memoria compartida para indexar los datos del historial almacenados en la caché del historial. El tamaño de la caché de índice necesita aproximadamente 100 bytes para almacenar en caché un elemento.  Predeterminado: `4M`<br> Rango: 128K-2G

en-us	# History object  The following objects are directly related to the `history` API.  ::: noteclassic History objects differ depending on the item's type of information. They are created by Zabbix server and cannot be modified via the API. :::
es	# Objeto de historial  Los siguientes objetos están directamente relacionados con la API `history`.   ::: noteclassic Los objetos de historial difieren según el tipo de información de la métrica. Son creados por el servidor Zabbix y no pueden ser modificados mediante la API. :::

en-us	# history.push
es	# history.push

en-us	**history.push**  For sending data to Zabbix server using the `history.push` API method, you could make the following HTTP POST request containing some test values:  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}' ```  If the request is correct, the response returned by API could look as follows:  ```json {     "jsonrpc": "2.0",     "result": {         "response": "success",         "data": [             {                 "itemid": "10600"             },             {                 "itemid": "10601",                 "error": "Item is disabled."             },             {                 "error": "No permissions to referred object or it does not exist."             }         ]     },     "id": 1 } ```  Errors in response data indicate that sending data for specific items has failed validation by Zabbix server. This can happen for the following reasons:  -   the user sending the data has no *read* permission to the item's host; -   the host is disabled or in maintenance without data collection; -   the item does not exist or is not yet included in the server configuration cache; -   the item is disabled or its type is other than Zabbix trapper or [HTTP agent](/manual/config/items/itemtypes/http) (with trapping enabled); -   the user's IP or DNS is not set in the item's *Allowed hosts* list; -   another item has a value with a duplicate timestamp on the nanosecond level.  The absence of errors indicates that the values sent have been accepted for processing, which includes preprocessing (if any), trigger processing, and saving to the database. Note that the processing of an accepted value may also fail (for example, during [preprocessing](/manual/config/items/preprocessing)), resulting in the value being discarded.  For more information on how to work with Zabbix API, see [API](/manual/api).
es	**historia.push**  Para enviar datos al servidor Zabbix utilizando el método API `history.push`, puede realizar la siguiente solicitud HTTP POST que contenga algunos valores de prueba:  ```golpecito curl --solicitud POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Autorización: Portador 0424bd59b807674191e7d77572075f33' \   --header 'Tipo de contenido: aplicación/json-rpc' \   --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"valor de prueba 1"},{"itemid" :10601,"valor":"valor de prueba 2"},{"itemid":99999,"valor":"valor de prueba 3"}],"id":1}' ```  Si la solicitud es correcta, la respuesta devuelta por la API podría verse de la siguiente manera:  ```json {     "jsonrpc": "2.0",     "resultado": {         "respuesta": "éxito",         "datos": [             {                 "itemid": "10600"             },             {                 "itemid": "10601",                 "error": "El elemento está deshabilitado."             },             {                 "error": "No hay permisos para el objeto referido o no existe."             }         ]     },     "identificación": 1 } ```  Los errores en los datos de respuesta indican que el envío de datos para elementos específicos no ha superado la validación del servidor Zabbix. Esto puede suceder por las siguientes razones:  - el usuario que envía los datos no tiene permiso de *lectura* para el host del elemento; - el host está deshabilitado o en mantenimiento sin recopilación de datos; - el elemento no existe o aún no está incluido en la caché de configuración del servidor; - el elemento está deshabilitado o su tipo no es el trampero Zabbix o [agente HTTP](/manual/config/items/itemtypes/http) (con el trampeo habilitado); - la IP o el DNS del usuario no están configurados en la lista *Hosts permitidos* del elemento; - otro elemento tiene un valor con una marca de tiempo duplicada en el nivel de nanosegundos.  La ausencia de errores indica que los valores enviados han sido aceptados para su procesamiento, lo que incluye el preprocesamiento (si corresponde), el procesamiento de activación y el guardado en la base de datos. Tenga en cuenta que el procesamiento de un valor aceptado también puede fallar (por ejemplo, durante el [preprocesamiento](/manual/config/items/preprocessing)), lo que provoca que el valor se descarte.  Para obtener más información sobre cómo trabajar con la API de Zabbix, consulte [API](/manual/api).

en-us	#### History  Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing.  [History API](/manual/api/reference/history)
es	#### Histórico  Obtenga los valores históricos recopilados por los procesos de monitorización de Zabbix, para su presentación o posterior procesamiento .  [API de Histórico](/manual/api/reference/history)

en-us	##### HistoryStorageDateIndex Enable preprocessing of history values in history storage to store values in different indices based on date.  Default: `0`<br> Values: 0 - disable; 1 - enable
es	##### HistoryStorageDateIndex Habilite el procesamiento previo de valores históricos en el almacenamiento histórico para almacenar valores en diferentes índices según la fecha.  Predeterminado: `0`<br> Valores: 0 - deshabilitar; 1 - habilitar

en-us	##### HistoryStorageTypes A comma-separated list of value types to be sent to the history storage. This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.  Default: `uint,dbl,str,log,text`
es	##### HistoryStorageTypes Una lista separada por comas de tipos de valores que se enviarán al almacenamiento del historial. Este parámetro se utiliza para la configuración de [Elasticsearch](/manual/appendix/install/elastic_search_setup).  Valor predeterminado: `uint,dbl,str,log,text`

en-us	##### HistoryStorageURL The history storage HTTP\[S\] URL. This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.
es	##### HistoryStorageURL La URL HTTP\[S\] de almacenamiento del historial. Este parámetro se utiliza para la configuración de [Elasticsearch](/manual/appendix/install/elastic_search_setup).

en-us	# History  This class is designed to work with history data.  Object references:  -   [Float history](/manual/api/reference/history/object#float_history) -   [Integer history](/manual/api/reference/history/object#integer_history) -   [String history](/manual/api/reference/history/object#string_history) -   [Text history](/manual/api/reference/history/object#text_history) -   [Log history](/manual/api/reference/history/object#log_history)  Available methods:  -   [history.clear](/manual/api/reference/history/clear) - clear history data -   [history.get](/manual/api/reference/history/get) - retrieve history data -   [history.push](/manual/api/reference/history/push) - send history data to Zabbix server
es	# Historial  Esta clase está diseñada para trabajar con datos históricos.  Referencias de objetos:  -   [Historial de flotantes](/manual/api/reference/history/object#float_history) -   [Historial de enteros](/manual/api/reference/history/object#integer_history) -   [Historial de cadenas](/manual/api/reference/history/object#string_history) -   [Historial de texto](/manual/api/reference/history/object#text_history) -   [Historial de registro](/manual/api/reference/history/object#log_history)  Métodos disponibles:  -   [history.clear](/manual/api/reference/history/clear) - borrar datos del historial -   [history.get](/manual/api/reference/history/get) - recuperar datos del historial -   [history.push](/manual/api/reference/history/push) - enviar datos del historial al servidor Zabbix

en-us	#### history  [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: Parameter `sortfield` now supports `ns`.\ [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Added new method `history.push`.\
es	#### history  [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: El parámetro `sortfield` ahora admite `ns`.\ [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Añadido el nuevo método `history.push`.\

en-us	#### Honeycomb  A *Honeycomb* widget has been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets), which offers a dynamic and vibrant overview of the monitored network infrastructure and resources, where host groups, such as virtual machines and network devices, along with their respective items, are visually represented as interactive hexagonal cells. For more information, see [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb).  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb.png){width="450"}
es	#### Panal  Se ha agregado un widget *Panal* a los [widgets del tablero](/manual/web_interface/frontend_sections/dashboards/widgets), que ofrece una descripción general dinámica y vibrante de la infraestructura y los recursos de la red monitoreados, donde se ubican los grupos de equipos, como las máquinas virtuales y los dispositivos de red, junto con sus respectivas métricas, se representan visualmente como celdas hexagonales interactivas. Para obtener más información, consulte [*Panal*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb).  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb.png){width="450"}

en-us	##### Host configuration  A host must be configured to process IPMI checks. An IPMI interface must be added, with the respective IP and port numbers, and IPMI authentication parameters must be defined.  See the [configuration of hosts](/manual/config/hosts/host) for more details.
es	##### Configuración del host  Se debe configurar un host para procesar comprobaciones de IPMI. Una interfaz IPMI debe agregarse, con los respectivos números de IP y puerto, e IPMI se deben definir los parámetros de autenticación.  Consulte la [configuración de hosts](/manual/config/hosts/host) para obtener más información. detalles.

en-us	##### Host configuration  You can specify that an individual host should be monitored by a proxy or proxy group  in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by* field.  ![](../../../assets/en/manual/proxies/proxy_set.png){width="600"}  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy or proxy group.
es	##### Configuración del equipo  Puede especificar que un equipo individual debe ser monitoreado por un proxy o un grupo de proxycampo en el formulario [configuración de equipo](/manual/config/hosts/host), usando el campo *Supervisado por*.  ![](../../../assets/en/manual/proxies/proxy_set.png){width="600"}  La [actualización masiva](/manual/config/hosts/hostupdate) de equipos es otra forma de especificar que los equipos deben ser monitoreados por un proxy o un grupo de proxy.

en-us	# host.create
es	# host.create

en-us	##### Host creation  A host is added if the *Add host* operation is selected. A host is also added, even if the *Add host* operation is missing, if you select operations resulting in actions on a host. Such operations are:  -   enable host -   disable host -   add host to a host group -   link template to a host  Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host groups* operation (specifying "Discovered hosts") and also add an *Add to host groups* operation (specifying another host group), because a host must belong to a host group.
es	##### Creación de equipo  Se agrega un equipo si se selecciona la operación *Agregar equipo*. Un equipo también es agregado, incluso si falta la operación *Agregar equipo*, si selecciona operaciones que resultan en acciones en un equipo. Tales operaciones son:  -   habilitar equipo -   deshabilitar el equipo -   agregar equipo a un grupo de equipos -   vincular plantilla a un equipo  Los equipos creados se agregan al grupo *Equipos descubiertos* (de forma predeterminada, configurable en *Administración* → *General* → *[Otros](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Si desea que los anfitriones se agreguen a otro grupo, agregue *Eliminar del grupo de equipos* (especificando "Equipos descubiertos") y también agregue un *Agregar al grupo de equipos* (especificando otro grupo de equipos), porque el equipo debe pertenecer a un grupo de equipos.

en-us	#### Host dashboards tabs  All of the configured [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) for the selected host are now displayed as tabs under the host dashboards page header, replacing the previous dropdown in the upper right corner. This allows easy transition between various host dashboards and improves navigation through monitoring data.
es	#### Pestañas de tableros de equipo  Todos los [paneles de equipo](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) configurados  para el equipo seleccionado ahora se muestran como pestañas debajo del encabezado de la página de tableros de equipo, reemplazando el menú desplegable anterior en la esquina superior derecha. Esto permite una fácil transición entre varios tableros de equipo y mejora la navegación a través de los datos de monitoreo.

en-us	# host.delete
es	# host.eliminar

en-us	# host.get
es	# host.get

en-us	# hostgroup.create
es	# hostgroup.create

en-us	# hostgroup.delete
es	# hostgroup.delete

en-us	# hostgroup.get
es	# hostgroup.get

en-us	# hostgroup.massadd
es	# hostgroup.massadd

en-us	# hostgroup.massremove
es	# hostgroup.massremove

en-us	# hostgroup.massupdate
es	# hostgroup.massupdate

en-us	# Host group object  The following objects are directly related to the `hostgroup` API.
es	# Objeto de grupo de equipos  Los siguientes objetos están directamente relacionados con la API `hostgroup`.

en-us	# hostgroup.propagate  
es	# hostgroup.propagate  

en-us	 ### Host groups  |Macro|Supported in|Description| |--|--------|--------| |{HOSTGROUP.ID}|→ Map element labels, map URL names and values|*Host group ID.*|
es	 ### Grupos de equipos  |Macro|Admitida en|Descripción| |--|--------|--------| |{HOSTGROUP.ID}|→ Etiquetas de elementos de mapa, nombres y valores de URL de mapa|*ID de grupo de equipos.*|

en-us	### Host group  The host group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |flags|integer|Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.|
es	### Grupo de equipos  El objeto de grupo de equipos tiene las siguientes propiedades.  |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |groupid|ID|ID del grupo de equipos.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*<br>- *obligatorio* para operaciones de actualización| |name|cadena|Nombre del grupo de equipos.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *obligatorio* para operaciones de creación| |flags|integer|Origen del grupo de equipos.<br><br>Valores posibles:<br>0: un grupo de equipos simple;<br>4: un grupo de equipos descubierto.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*| |uuid|cadena|Identificador único universal, utilizado para vincular grupos de equipos importados con los ya existentes. Generado automáticamente, si no se proporciona.|

en-us	# Host group  This class is designed to work with host groups.  Object references:  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  Available methods:  -   [hostgroup.create](/manual/api/reference/hostgroup/create) - create new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) - delete host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieve host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - add related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - remove related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - replace or remove related objects from host groups -   [hostgroup.propagate](/manual/api/reference/hostgroup/propagate) - propagate permissions and tag filters to host groups' subgroups -   [hostgroup.update](/manual/api/reference/hostgroup/update) - update host groups
es	# Grupo de equipos  Esta clase está diseñada para trabajar con grupos de equipos.  Referencias de objetos:  - [Grupo de equipos](/manual/api/reference/hostgroup/object#host_group)  Métodos disponibles:  -   [hostgroup.create](/manual/api/reference/hostgroup/create) - crear nuevos grupos de equipos -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) - eliminar grupos de equipos -   [hostgroup.get](/manual/api/reference/hostgroup/get) - obtener grupos de equipos -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - agregar objetos relacionados a grupos de equipos -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - eliminar objetos relacionados de grupos de equipos -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - reemplazar o eliminar objetos relacionados de grupos de equipos -   [hostgroup.propagate](/manual/api/reference/hostgroup/propagate) -  propagar permisos y filtros de etiquetas a los subgrupos de los grupos de equipos -   [hostgroup.update](/manual/api/reference/hostgroup/update) - actualizar grupos de equipos

en-us	# hostgroup.update
es	# hostgroup.update

en-us	#### hostgroup  [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: Method now also supports `status` property if `selectGroupDiscoveries` parameter is used.
es	#### hostgroup  [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: El método también soporta ahora la propiedad `status` si se usa el parámetro `selectGroupDiscoveries`.

en-us	#### hostgroup  [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed parameters `selectHostPrototype` to `selectHostPrototypes`, `selectDiscoveryRule` to `selectDiscoveryRules`, `selectGroupDiscovery` to `selectGroupDiscoveries`; now each parameter will return an array of objects instead of an object.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed output properties `hostPrototype` to `hostPrototypes`, `discoveryRule` to `discoveryRules`, `groupDiscovery` to `groupDiscoveries`.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Removed support for `groupid` property in `selectGroupDiscoveries` (previously - `selectGroupDiscovery`) parameter.\
es	#### hostgroup  [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: parámetros renombrados `selectHostPrototype` a `selectHostPrototypes`, `selectDiscoveryRule` a `selectDiscoveryRules`, `selectGroupDiscovery` a `selectGroupDiscoveries`; ahora cada parámetro devolverá una matriz de objetos en lugar de un objeto.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: propiedades de salida renombradas `hostPrototype` a `hostPrototypes`, `discoveryRule` a `discoveryRules`, `groupDiscovery` a `groupDiscoveries`.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: se eliminó la compatibilidad con la propiedad `groupid` en el parámetro `selectGroupDiscoveries` (anteriormente - `selectGroupDiscovery`).\

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
es	##### HostInterface  Un parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo. Si no se define, el valor se adquirirá de HostInterfaceItem.<br>El agente emitirá un error y no se iniciará si el valor supera el límite de 255 caracteres.  Rango: 0-255 caracteres

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
es	##### HostInterface  Un parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo. Si no se define, el valor se adquirirá de HostInterfaceItem.<br>El agente emitirá un error y no se iniciará si el valor supera el límite de 255 caracteres.  Rango: 0-255 caracteres

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
es	##### HostInterface  Un parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo. Si no se define, el valor se adquirirá de HostInterfaceItem.<br>El agente emitirá un error y no se iniciará si el valor supera el límite de 255 caracteres.  Rango: 0-255 caracteres

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
es	##### HostInterface  Un parámetro opcional que define la interfaz del equipo. La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo. Si no se define, el valor se adquirirá de HostInterfaceItem.<br>El agente emitirá un error y no se iniciará si el valor supera el límite de 255 caracteres.  Rango: 0-255 caracteres

en-us	# hostinterface.create
es	# hostinterface.create

en-us	# hostinterface.delete
es	# hostinterface.delete

en-us	# hostinterface.get
es	# hostinterface.get

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>This option is only used when HostInterface is not defined.
es	##### HostInterfaceItem  Un parámetro opcional que define una métrica utilizada para obtener la interfaz del equipo.<br>La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo.<br>Durante una solicitud de registro automático, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 255 caracteres.<br>La métrica [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) se admite independientemente de los valores de AllowKey/DenyKey.<br>Esta opción solo se usa cuando HostInterface no está definido.

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>This option is only used when HostInterface is not defined.
es	##### HostInterfaceItem  Un parámetro opcional que define una métrica utilizada para obtener la interfaz del equipo.<br>La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo.<br>Durante una solicitud de registro automático, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 255 caracteres.<br>La métrica [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) se admite independientemente de los valores de AllowKey/DenyKey.<br>Esta opción solo se usa cuando HostInterface no está definido.

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. This option is only used when HostInterface is not defined.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.
es	##### HostInterfaceItem  Un parámetro opcional que define una métrica utilizada para obtener la interfaz del equipo.<br>La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo. Esta opción solo se usa cuando HostInterface no está definido.<br>La métrica [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) se admite independientemente de los valores AllowKey/DenyKey.<br >Durante una solicitud de registro automático, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 255 caracteres.

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. This option is only used when HostInterface is not defined.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.
es	##### HostInterfaceItem  Un parámetro opcional que define una métrica utilizada para obtener la interfaz del equipo.<br>La interfaz del equipo se utiliza en el proceso de [autorregistro](/manual/discovery/auto_registration#using_dns_as_default_interface) del equipo. Esta opción solo se usa cuando HostInterface no está definido.<br>La métrica [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) se admite independientemente de los valores AllowKey/DenyKey.<br >Durante una solicitud de registro automático, el agente registrará un mensaje de advertencia si el valor devuelto por la métrica especificada supera el límite de 255 caracteres.

en-us	# hostinterface.massadd
es	# hostinterface.massadd

en-us	# hostinterface.massremove
es	# hostinterface.massremove

en-us	# Host interface object  The following objects are directly related to the `hostinterface` API.
es	# Objeto de interfaz de equipo  Los siguientes objetos están directamente relacionados con la API `hostinterface`.

en-us	# hostinterface.replacehostinterfaces
es	# hostinterface.replacehostinterfaces

en-us	#### Host interfaces  |Element|<|Type|Description| |-|---|---|-----------------------| |default|<|string|Whether this is the primary host interface. Note that there can be only one primary interface of one type on a host.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |type|<|string|Interface type.<br>Possible values:^[1](#footnotes)^ ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).| |useip|<|string|Whether to use IP as the interface for connecting to the host (otherwise, DNS will be used).<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |ip|<|string|(required for IP connections) IP address (IPv4 or IPv6).| |dns|<|string|(required for DNS connections) DNS name.| |port|<|string|Port number.| |details|<| |Root element for interface details.| |<|version|string|Use this SNMP version.<br>Possible values:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, default), SNMP\_V3 (3).| |^|community|string|(required for SNMPv1 and SNMPv2 items) SNMP community.| |^|max_repetitions|string|Max repetition value for native SNMP bulk requests (GetBulkRequest-PDUs).<br>Supported for SNMPv2 and SNMPv3 items (`discovery[]` and `walk[]` items).<br>Default: 10.| |^|contextname|string|SNMPv3 context name.<br>Supported for SNMPv3 items.| |^|securityname|string|SNMPv3 security name.<br>Supported for SNMPv3 items.| |^|securitylevel|string|SNMPv3 security level.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).| |^|authprotocol|string|SNMPv3 authentication protocol.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).| |^|authpassphrase|string|SNMPv3 authentication passphrase.<br>Supported for SNMPv3 items.| |^|privprotocol|string|SNMPv3 privacy protocol.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).| |^|privpassphrase|string|SNMPv3 privacy passphrase.<br>Supported for SNMPv3 items.| |^|bulk|string|Use bulk requests for SNMP.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |interface\_ref|<|string|Interface reference name to be used in items (format: `if<N>`).|  ::: noteclassic See also: [Host interface object](/manual/api/reference/hostinterface/object) (refer to the relevant property with a matching name). :::
es	#### Interfaces de equipo  |Elemento|<|Tipo|Descripción| |-|---|---|-----------------------| |default|<|cadena|Si esta es la interfaz del equipo principal. Tenga en cuenta que sólo puede haber una interfaz principal de un tipo en un equipo.<br>Valores posibles:^[1](#footnotes)^ NO (0), SÍ (1, predeterminado).| |type|<|cadena|Tipo de interfaz.<br>Valores posibles:^[1](#footnotes)^ ZABBIX (1, predeterminado), SNMP (2), IPMI (3), JMX (4).| |useip|<|cadena|Si se debe usar IP como interfaz para conectarse al host (de lo contrario, se usará DNS).<br>Valores posibles:^[1](#footnotes)^ NO (0), SÍ ( 1, predeterminado).| |ip|<|cadena|(obligatorio para conexiones IP) Dirección IP (IPv4 o IPv6).| |dns|<|cadena|(obligatorio para conexiones DNS) Nombre DNS.| |port|<|cadena|Número de puerto.| |details|<| |Elemento raíz para detalles de la interfaz.| |<|version|cadena|Utilice esta versión de SNMP.<br>Valores posibles:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, predeterminado), SNMP\_V3 (3).| |^|community|cadena|Comunidad SNMP (obligatorio para métricas SNMPv1 y SNMPv2).| |^|max_repetitions|cadena|Valor máximo de repetición para solicitudes masivas SNMP nativas (GetBulkRequest-PDU).<br>Compatible con métricas SNMPv2 y SNMPv3 (métricas `discovery[]` y `walk[]`).<br>Valor predeterminado: 10.| |^|contextname|cadena|Nombre de contexto SNMPv3.<br>Compatible con métricas SNMPv3.| |^|securityname|cadena|Nombre de seguridad SNMPv3.<br>Compatible con métricas SNMPv3.| |^|securitylevel|cadena|Nivel de seguridad SNMPv3.<br>Compatible con métricas SNMPv3.<br>Valores posibles:^[1](#footnotes)^ NOAUTHNOPRIV (0, predeterminado), AUTHNOPRIV (1), AUTHPRIV (2) .| |^|authprotocol|string|Protocolo de autenticación SNMPv3.<br>Compatible con métricas SNMPv3.<br>Valores posibles:^[1](#footnotes)^ MD5 (0, predeterminado), SHA1 (1), SHA224 (2) , SHA256 (3), SHA384 (4), SHA512 (5).| |^|authpassphrase|string|Frase de contraseña de autenticación SNMPv3.<br>Compatible con métricas SNMPv3.| |^|privprotocol|string|Protocolo de privacidad SNMPv3.<br>Compatible con métricas SNMPv3.<br>Valores posibles:^[1](#footnotes)^ DES (0, predeterminado), AES128 (1), AES192 (2) , AES256 (3), AES192C (4), AES256C (5).| |^|privpassphrase|string|Frase de contraseña de privacidad SNMPv3.<br>Compatible con métricas SNMPv3.| |^|bulk|string|Usar solicitudes masivas para SNMP.<br>Valores posibles:^[1](#footnotes)^ NO (0), SÍ (1, predeterminado).| |interface\_ref|<|cadena|Nombre de referencia de la interfaz que se utilizará en las métricas (formato: `if<N>`).|  ::: noteclassic Consulte también: [Objeto de interfaz de equipo](/manual/api/reference/hostinterface/object) (consulte la propiedad relevante con un nombre coincidente). :::

en-us	##### Host interfaces  To add custom interfaces, switch the *Interface* selector from "Inherit" to "Custom". Click ![add\_link.png](../../../../assets/en/manual/config/add_link.png) and select the interface type - Zabbix agent, SNMP, JMX, IPMI.  ::: noteclassic If *Custom* is selected, but no interfaces have been set, the hosts will be created without interfaces.<br> If *Inherit* is selected and the host prototype belongs to a template, all discovered hosts will inherit the host interface from the host to which the template is linked. :::  If multiple custom interfaces are specified, the primary interface can be set in the *Default* column.  For an example of how to configure a custom host interface, see [*VMware monitoring setup example*](/manual/vm_monitoring/example#advanced-host-interface-configuration).  ::: notewarning A host will only be created if a host interface contains correct data. :::
es	##### Interfaces del equipo  Para agregar interfaces personalizadas, cambie el selector *Interfaz* de "Heredar" a "Personalizado". Haga clic en ![add\_link.png](../../../../assets/en/manual/config/add_link.png) y seleccione el tipo de interfaz: agente Zabbix, SNMP, JMX, IPMI.  ::: noteclassic Si se selecciona *Personalizado*, pero no se han configurado interfaces, los equipos se crearán sin interfaces.<br> Si se selecciona *Heredar* y el prototipo de equipos pertenece a una plantilla, todos los equipos descubiertos heredarán la interfaz del equipo al que está vinculada la plantilla. :::  Si se especifican varias interfaces personalizadas, la interfaz principal se puede configurar en la columna *Predeterminada*.  Para ver un ejemplo de cómo configurar una interfaz de equipo personalizada, consulte el [*ejemplo de configuración de monitoreo de VMware*](/manual/vm_monitoring/example#advanced-host-interface-configuration).  ::: notewarning Solo se creará un equipo si una interfaz de equipo contiene datos correctos. :::

en-us	### Host interface  The host interface object has the following properties.  ::: noteimportant Note that both `ip` and `dns` properties are *required* for create operations. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |interfaceid|ID|ID of the interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |available|integer|Availability of host interface.<br><br>Possible values:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |hostid|ID|ID of the host that the interface belongs to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |type|integer|Interface type.<br><br>Possible values:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |ip|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |dns|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |port|string|Port number used by the interface.<br>Can contain user macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |useip|integer|Whether the connection should be made via IP.<br><br>Possible values:<br>0 - connect using host DNS name;<br>1 - connect using host IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |main|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values:<br>0 - not default;<br>1 - default.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |details|array|Additional [details](#details) object for interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP"| |disable\_until|timestamp|The next polling time of an unavailable host interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |error|string|Error text if host interface is unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |errors\_from|timestamp|Time when host interface became unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
es	### Interfaz de equipo  El objeto de interfaz de equipo tiene las siguientes propiedades.  ::: noteimportant Tenga en cuenta que las propiedades `ip` y `dns` son *requeridas* para las operaciones de creación. Si no desea utilizar DNS, configúrelo en una cadena vacía. :::  |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |interfaceid|ID|ID de la interfaz.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*<br>- *obligatorio* para operaciones de actualización| |available|entero|Disponibilidad de la interfaz del equipo.<br><br>Valores posibles:<br>0 - *(predeterminado)* desconocido;<br>1 - disponible;<br>2 - no disponible.<br><br >[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*| |hostid|ID|ID del equipo al que pertenece la interfaz.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *constante*<br>- * requerido* para crear operaciones| |type|entero|Tipo de interfaz.<br><br>Valores posibles:<br>1 - Agente;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br >[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *obligatorio* para operaciones de creación| |ip|cadena|Dirección IP utilizada por la interfaz.<br><br>Puede estar vacía si la conexión se realiza mediante DNS.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior ):<br>- *obligatorio* para operaciones de creación| |dns|cadena|Nombre DNS utilizado por la interfaz.<br><br>Puede estar vacío si la conexión se realiza vía IP.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior ):<br>- *obligatorio* para operaciones de creación| |port|cadena|Número de puerto utilizado por la interfaz.<br>Puede contener macros de usuario.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *obligatorio* para crear operaciones | |useip|entero|Si la conexión debe realizarse a través de IP.<br><br>Valores posibles:<br>0: conectarse usando el nombre DNS del equipo;<br>1: conectarse usando la dirección IP del equipo.<br><br >[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *obligatorio* para operaciones de creación| |main|entero|Si la interfaz se utiliza de forma predeterminada en el host. Solo se puede configurar una interfaz de algún tipo como predeterminada en un host.<br><br>Valores posibles:<br>0: no predeterminado;<br>1: predeterminado.<br><br>[Comportamiento de la propiedad]( /manual/api/reference_commentary#property-behavior):<br>- *obligatorio* para operaciones de creación| |details|matriz|Objetoadicional de [detalles](#details)  para la interfaz.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *obligatorio* si `tipo ` está configurado en "SNMP"| |disable\_until|timestamp|La próxima hora de sondeo de una interfaz de equipo no disponible.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*| |error|cadena|Texto de error si la interfaz del equipo no está disponible.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*| |errors\_from|marca de tiempo|Hora en que la interfaz del equipo dejó de estar disponible.<br><br>[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):<br>- *solo lectura*|

en-us	# Host interface  This class is designed to work with host interfaces.  Object references:  -   [Host interface](/manual/api/reference/hostinterface/object#host_interface) -   [Details](/manual/api/reference/hostinterface/object#details)  Available methods:  -   [hostinterface.create](/manual/api/reference/hostinterface/create) - create new host interfaces -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) - delete host interfaces -   [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieve host interfaces -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - add host interfaces to hosts -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - remove host interfaces from hosts -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replace host interfaces on a host -   [hostinterface.update](/manual/api/reference/hostinterface/update) - update host interfaces
es	# Interfaz de equipo  Esta clase está diseñada para funcionar con interfaces de equipo.  Referencias de objeto:  -   [Interfaz de equipo](/manual/api/reference/hostinterface/object#host_interface) -   [Detalles](/manual/api/reference/hostinterface/object#details)  Métodos disponibles:  -   [hostinterface.create](/manual/api/reference/hostinterface/create) - crea nuevas interfaces de equipo -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) - eliminar interfaces de equipo -   [hostinterface.get](/manual/api/reference/hostinterface/get) - recuperar interfaces de equipo -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - agrega interfaces de equipo a equipos -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - elimina las interfaces de equipo de los equipos -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - reemplaza las interfaces de equipo en un equipo -   [hostinterface.update](/manual/api/reference/hostinterface/update) - actualiza las interfaces del equipo

en-us	# hostinterface.update
es	# hostinterface.update