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"    } ] ```
ca	#### Processament de la capçalera  #### Procés de la capçalera  La línia de capçalera del fitxer CSV es pot processar de dues maneres diferents:  - Si la casella *Amb filera de capçalera* és marcada, els valors de la filera de capçalera s'interpreten com a noms de columna. En aquest cas, els noms de les columnes han d'ésser únics i la filera de dades no ha de contindre més columnes que la filera de capçalera; - Si la casella *Amb filera de capçalera* no és pas marcada, la filera de capçalera s'interpreta com a dades. Els noms de les columnes es generen automàticament (1,2,3,4...)  Exemple de fitxer CSV:       Nombre, nom de l'element, clau, quantitat      1, element agent actiu, agent.hostname,33      "2","element d'agent passiu","agent.version","44"      3,"elements d'agent actiu i passiu", agent.ping,55  :::noteclassic Les cometes en un camp entre cometes de l'entrada s'han d'escapar precedint-les amb una altra cometa. :::  **Processament de filera de capçalera**  Sortida JSON quan s'espera una filera de capçalera:  ``` {.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 es processa cap filera de capçalera**  Sortida JSON quan no s'espera una filera de capçalera:  ``` {.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	##### Hidden menu  Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. 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.
ca	##### Menu amagat  Fins i tot quan el menú és totalment amagat, un menú complet és a només un clic de distància, fent clic a la icona de l'hamburguesa. Tingueu en compte que reapareix al contingut de la pàgina; per moure el contingut de la pàgina cap a la dreta, heu de mostrar el menú fent clic al botó Mostra la barra lateral.

en-us	#### Hiding the file with list of common passwords  To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  For example, on NGINX file access can be limited by using the `location` directive:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```  On Apache - by using `.htaccess` file:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```
ca	#### Amagar l'arxiu amb la llista de mots de pas comuns  Per augmentar la complexitat dels atacs de força bruta amb mots de pas, es recomana limitar l'accés al fitxer `ui/data/top_passwords.txt` modificant la configuració del servidor web. Aquest fitxer conté una llista dels mots de pas més comuns i específics del context, i s'empra per evitar que els usuaris estableixin aquests mots de pas si la configuració *Evitar mots de pas fàcils d'endevinar* és activada a la [política de seguretat dels mots de pas](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  Per exemple, sota NGINX, l'accés als fitxers es pot limitar emprant la directiva "location":     ```     location = /data/top_passwords.txt {​​​​​​​         deny all;         return 404;     }​​​​​​​    ```  Sota Apache - emprant l'arxiu `.htaccess`:  ```ini     <Files "top_passwords.txt">         Order Allow,Deny       Deny from all     </Files> ```

en-us	#### High availability cluster for Zabbix server  The new version comes with a native high availability solution for Zabbix server.  The solution consists of multiple zabbix\_server instances or nodes, where only one node can be active (working) at a time, while other nodes are on standby, ready to take over in case the current node is stopped or fails.  See also: [High availability cluster](/manual/concepts/server/ha).
ca	### Cluster d'alta disponibilitat per al servidor Zabbix  La nova versió inclou una solució nadiua d'alta disponibilitat per al servidor Zabbix.  La solució consta de múltiples instàncies o nodes de zabbix\_server, on només un node pot ésser actiu (funcionant) alhora, mentre que els altres nodes són en espera, preparats per fer-se càrrec en cas que el node actual sigui caigut o falli.  Veieu també: [Cluster d'alta disponibilitat](/manual/concepts/server/ha).

en-us	#### High availability cluster  Retrieve a list of server nodes and their status.  [High availability cluster API](/manual/api/reference/hanode)
ca	#### Cluster d'alta disponibilitat  Recupera una llista de nodes de servidors i el seu estat.  [API Cluster d'Alta Disponibilitat](/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|string|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, t.i. 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.|
ca	### Node d'alta disponibilitat  ::: noteclassic Els nodes són creats pel servidor de Zabbix i no pot ésser pas modificat via l'API. :::  L'objecte node d'alta disponibilitat té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |ha\_nodeid|string|ID del node.| |name|string|Nom assignat al node, emprant la configuració HANodeName a zabbix\_server.conf. Buit per a servidors executant-se de manera autònoma.| |address|string|IP o nom DNS des d'on connecta el node.| |port|integer|Port on el node és funcionant.| |lastaccess|integer|temps de Heartbeat: hora de la darrera actualització des del node. En temps UTC.| |status|integer|Estat del node.<br><br>Valors possibles:<br>0 - standby;<br>1 - aturat manualment;<br>2 - no disponible;<br>3 - actiu.|

en-us	# > High availability node object  The following object is related to operating a High availability cluster of Zabbix servers.
ca	# > Objecte de node d'alta disponibilitat  El següent objecte serveix per operar amb un cluster d'alta disponibilitat de servidors 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|
ca	#### Nodes d'alta disponibilitat  Si el [clúster HA](/manual/concepts/server/ha) és habilitat, es veu un altre bloc de dades amb l'estat de cada node HA.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Dades mostrades:  |Columna|Descripció| |--|---------| |*Nom*|Nom del node, tal com es defineix a la configuració del servidor.| |*Adreça*|Adreça IP i port del node.| |*DArrer accés*|Hora del darrer accés al node.<br>Si passeu el cursor per sobre de la cel·la, es veu la marca de temps del darrer accés en format llarg.| |*Estat*|Estat del node:<br>**Activat** - el node és en funcionament<br>**No disponible** - el node no s'ha vist durant més que el temps de migració per error (pot ser que vulgueu saber per què)<br>**Aturat** - el node s'ha aturat o no s'ha pogut iniciar (podeu iniciar-lo o esborrar-lo)<br>**Pendent** - el node és actiu i pendent|

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#hanode)  Available methods:\  -   [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes
ca	# Node d'alta disponibilitat  Aquesta classe és pensada per treballar amb servidors nodes que són part d'un cluster d'alta disponibilitat, o amb una instància de servidor autònom.  Referències dels objectes:\  -   [Node d'alta disponibilitat](/manual/api/reference/hanode/object#hanode)  Mètodes disponibles:\  -   [hanode.get](/manual/api/reference/hanode/get) - consultar els nodes

en-us	#### history  Changes:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) added new API method `history.clear`.\
ca	#### historial  Canvis:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) afegit un nou mètode d'API `history.clear`.\

en-us	# history.clear
ca	# history.clear

en-us	#### History functions  |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**change** (/host/key)|<|<| |The amount of difference between the previous and latest value.| |Supported value types: float, int, str, text, log<br><br>For strings returns:<br>0 - values are equal<br>1 - values differ<br><br>Example:<br>=> **change**(/host/key)>10<br><br>Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`<br><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Number of changes between adjacent values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**mode** (optional; must be double-quoted)<br><br>Supported `modes`:<br>*all* - count all changes (default)<br>*dec* - count decreases<br>*inc* - count increases|Supported value types: float, int, str, text, log<br><br>For non-numeric value types, *mode* parameter is ignored.<br><br>Examples:<br>=> **changecount**(/host/key, 1w) → number of value changes for the last week until [now](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → number of value increases (relative to the adjacent value) among the last 10 values<br>=> **changecount**(/host/key,24h,"dec") → number of value decreases (relative to the adjacent value) for the last 24 hours until [now](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Number of values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **count**(/host/key,**10m**) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **count**(/host/key,**10m**,,12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that equal '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → number of values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **count**(/host/key,**10m:now-1d**) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Number of unique values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **countunique**(/host/key,**10m**) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key,**10m**,"like","error") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **countunique**(/host/key,**10m**,"gt",12) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**\#10**,"gt",12) → number of unique values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **countunique**(/host/key,**10m:now-1d**) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<| |Find a value match.|See [common parameters](#common-parameters).<br><br>**sec** or **\#num** (optional) - defaults to the latest value if not specified<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - value contains the string given in `pattern` (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** - required pattern (string arguments must be double-quoted); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regular expression if `operator` is *regexp*, *iregexp*.|Supported value types: float, int, str, text, log<br><br>Returns:<br>1 - found<br>0 - otherwise<br><br>If more than one value is processed, '1' is returned if there is at least one matching value.<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings.<br><br>Example:<br>=> **find**(/host/key,**10m**,"like","error") → find a value that contains 'error' within the last 10 minutes until [now](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<| |The first (the oldest) value within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int, str, text, log<br><br>Example:<br>=> **first**(/host/key,**1h**) → retrieve the oldest value within the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>See also last().| |**fuzzytime** (/host/key,sec)|<|<| |Checking how much the passive agent time differs from the Zabbix server/proxy time.|See [common-parameters](#common parameters).|Supported value types: float, int<br><br>Returns:<br>1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp (clock of value collection) is less than or equal to T seconds<br>0 - otherwise<br><br>Usually used with the 'system.localtime' item to check that local time is in sync with the local time of Zabbix server. *Note* that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks).<br>Can be used also with vfs.file.time\[/path/file,modify\] key to check that file didn't get updates for long time.<br><br>Example:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detect a problem if the time difference is over 60 seconds<br><br>This function is not recommended for use in complex trigger expressions (with multiple items involved), because it may cause unexpected results (time difference will be measured with the most recent metric), e.g. in `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<| |The most recent value.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: float, int, str, text, log<br><br>Take note that a hash-tagged time period (\#N) works differently here than with many other functions.<br>For example:<br>last() is always equal to last(\#1)<br>last(\#3) - third most recent value (*not* three latest values)<br><br>Zabbix does not guarantee the exact order of values if more than two values exist within one second in history.<br><br>Example:<br>=> **last**(/host/key) → retrieve the last value<br>=> **last**(/host/key,**\#2**) → retrieve the previous value<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,**\#2**) → the last and previous values differ<br><br>See also first().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Checking if event ID of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<| |Log severity of the last log entry.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: log<br><br>Returns:<br>0 - default severity<br>N - severity (integer, useful for Windows event logs: 1 - Information, 2 - Warning, 4 - Error, 7 - Failure Audit, 8 - Success Audit, 9 - Critical, 10 - Verbose).<br>Zabbix takes log severity from **Information** field of Windows event log.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Checking if log source of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches<br><br>Normally used for Windows event logs. For example, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Check if there has been a monotonous decrease in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is smaller or the same as the previous one; default) or *strict* (every value has decreased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously decrease, 0 otherwise.<br><br>Example:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calculate in how many hosts there has been a decrease in free swap size| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Check if there has been a monotonous increase in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is bigger or the same as the previous one; default) or *strict* (every value has increased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously increase, 0 otherwise.<br><br>Example:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - check if system local time has been increasing consistently| |**nodata** (/host/key,sec,<mode>)|<|<| |Checking for no data received.|See [common parameters](#common-parameters).<br><br>**sec** period should not be less than 30 seconds because the history syncer process calculates this function only every 30 seconds.<br><br>nodata(/host/key,0) is disallowed.<br><br>**mode** - if set to *strict* (double-quoted), this function will be insensitive to proxy availability (see comments for details).|All value types are supported.<br><br>Returns:<br>1 - if no data received during the defined period of time<br>0 - otherwise<br><br>Since Zabbix 5.0, the 'nodata' triggers monitored by proxy are, by default, sensitive to proxy availability - if proxy becomes unavailable, the 'nodata' triggers will not fire immediately after a restored connection, but will skip the data for the delayed period. Note that for passive proxies suppression is activated if connection is restored more than 15 seconds and no less than 2 & ProxyUpdateFrequency seconds later. For active proxies suppression is activated if connection is restored more than 15 seconds later.<br><br>To turn off sensitiveness to proxy availability, use the third parameter, e.g.: **nodata**(/host/key,**5m**,**"strict"**); in this case the function will work the same as before 5.0.0 and fire as soon as the evaluation period (five minutes) without data has past.<br><br>Note that this function will display an error if, within the period of the 1st parameter:<br>- there's no data and Zabbix server was restarted<br>- there's no data and maintenance was completed<br>- there's no data and the item was added or re-enabled<br>Errors are displayed in the *Info* column in trigger [configuration](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>This function may not work properly if there are time differences between Zabbix server, proxy and agent. See also: [Time synchronization requirement](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<| |P-th percentile of a period, where P (percentage) is specified by the third parameter.|See [common parameters](#common-parameters).<br><br>**percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point|Supported value types: float, int| |**rate** (/host/key,sec<:time shift>)|<|<| |Per-second average rate of the increase in a monotonically increasing counter within the defined time period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.<br><br>Example:<br>=> **rate**(/host/key,**30s**) → If the monotonic increase over 30 seconds is 20, this function will return 0.67.|
ca	#### Funcions d'històric  |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**change** (/host/key)|<|<| |La quantitat de diferència entre el valor anterior i l'últim.| |Tipus de valors admesos: float, int, str, text, log<br><br>Per a les cadenes retorna:<br>0 - els valors són iguals<br>1 - els valors són diferents<br><br>Exemple:<br> => **change**(/host/key)>10<br><br>Es calcularà la diferència numèrica, tal com es veu en aquests valors d'exemple entrants (valor 'anterior' i 'darrer' = diferència):<br> "1" i "5" = "+4"<br>"3" i "1" = "-2"<br>"0" i "-2,5" = "-2,5"<br><br>Veieu també: [abs](/manual/apèndix/funcions/matemàtiques) per a la comparació| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Nombre de canvis entre valors adjacents dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (opcional; s'ha de fer entre cometes)<br>< br>Modes admesos:<br>*all* - comptar tots els canvis (predeterminat)<br>*dec* - recompte disminueix<br>*inc* - recompte augmenta|Tipus de valors admesos: float, int, str, text , registre<br><br>Per als tipus de valors no numèrics, el paràmetre *mode* s'ignora.<br><br>Exemples:<br>=> **changecount**(/host/key, 1w) → nombre de canvis de valor durant la darrera setmana fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → nombre d'augments de valor (en relació amb el valor adjacent) entre els darrers 10 valors<br>=> **changecount**(/host/key,24h,"dec") → el nombre de disminucions de valor (en relació amb el valor adjacent) durant le darreres 24 hores fins a [ara](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operador>,<pattern>)|<|<| |Nombre de valors dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**operador** (opcional; ha d'ésser entre cometes)<br><br>Admet `operadors`:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - major de<br>*ge* - major o igual<br>*lt* - menor de <br>*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - concordança sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br><br>**patró** (opcional) - patró obligatori (els arguments de cadena han d'ésser entre cometes dobles)|Tipus de valors admesos: flotant, enter, cadena, text, registre<br><br>Els elements flotants coincideixen amb la precisió de 2.22e-16; si la base de dades no és [actualitzada](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) la precisió és de 0,000001.<br><br>Amb *bitand* com a tercer paràmetre, el quart paràmetre `patró` es pot especificar com a dos nombres, separats per "/": **nombre\_a\_comparar\_amb/màscara**. count() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre\_a\_comparar\_amb*. Si el resultat de "AND bit a bit" és igual a *nombre\_a\_comparar\_amb*, es compta el valor.<br>Si *nombre\_a\_comparar\_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions# global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.<br><br>Exemples:<br>=> **count**(/ host/key,**10m**) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,* *10m**,"like","error") → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que contenen "error"<br>=> **count**(/host/key,**10m**,,12) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que són iguals a '12'<br>=> * *count**(/host/key,**10m**,"gt",12) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que són superiors a '12 '<br>=> **count**(/host/key,**\#10**,"gt",12) → nombre de valors dins dels darrers 10 valors fins a [ara](/manual/config/ triggers#evaluation_period) que superen '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt" ,12) → nombre de valors entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period) que eren superiors a '12'<br>=> **count**(/host /key,**10m**,"bitand","6/7") → nombre de valors dels darrers 10 minuts fins [ara](/manual/config/triggers#evaluation_period) que tinguin '110' (en binari) als 3 bits menys significatius.<br>=> **count**(/host/key,**10m:now-1d**) → nombre de valors entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Nombre de valors únics dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**operador** (opcional; ha d'estar entre cometes)<br><br> `Operadors` admesos:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - més gran de <br>*ge* - major o igual<br>*lt* - més petit de <br>*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'element normal expressió donada a `pattern`<br>*iregexp*: coincidència sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br><br>**patró** (opcional) - patró obligatori (els arguments de la cadena han d'ésser dobles)|Tipus de valors admesos: flotant, enter, cadena, text, registre<br><br>Els elements flotants coincideixen amb la precisió de 2.22e-16; si la base de dades no és [actualitzada](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) la precisió és 0,000001.<br><br>Amb *bitand* com a tercer paràmetre, el quart paràmetre "patró" es pot especificar com a dos nombres, separats per "/": **nombre\_a\_comparar\_amb/màscara**. count() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre\_a\_comparar\_amb*. Si el resultat de "AND bit a bit" és igual a *nombre\_a\_comparar\_amb*, es compta el valor.<br>Si *nombre\_a\_comparar\_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions# global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.<br><br>Exemples:<br>=> **countunique**(/ host/key,**10m**) → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key, **10m**,"like","error") → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que contenen "error"<br>=> ** countunique**(/host/key,**10m**,"gt",12) → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que superen el '12 '<br>=> **countunique**(/host/key,**\#10**,"gt",12) → nombre de valors únics dins dels darrers 10 valors fins a [ara](/manual/config /triggers#evaluation_period) que superen '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → nombre de valors únics entre 24 fa hores i 10 minuts i 24 hores des d'[ara](/man ual/config/triggers#evaluation_period) que eren superiors a '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → nombre d'únics valors dels darrers 10 minuts fins [ara](/manual/config/triggers#evaluation_period) tingui '110' (en binari) als 3 bits menys significatius.<br>=> **countunique**(/host/key ,**10m:now-1d**) → nombre de valors únics entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operador>,<pattern>)|<|<| |Cerca una coincidència de valor.|Veieu [paràmetres comuns](#common-parameters).<br><br>**sec** o **\#num** (opcional) - per defecte el valor més recent si no s'especifica <br><br>**operador** (opcional; ha d'ésser entre cometes)<br><br>"operadors" admesos:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - major de<br>*ge* - major o igual<br>*lt* - menor de<br>*le* - menor o igual<br>*com* - el valor conté la cadena donada a `pattern` (distingeix entre majúscules i minúscules)<br>*bitand* - bit a bit AND<br>*regexp* - concordança sensible a majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - coincidència insensible a majúscules i minúscules del expressió regular donada a `pattern`<br><br>**patró** - patró obligatori (els arguments de cadena han d'ésser entre cometes); [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) expressió regular si `operador` és *regexp*, *iregexp*.|Tipus de valors admesos: float, int, str, text, registre<br><br>Retorna:<br>1 - trobat<br>0 - en cas contrari<br><br>Si es processa més d'un valor, es retorna '1' si hi ha almenys un valor coincident.<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o  una expressió regular [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars.<br><br>Exemple:<br>=> **find**(/host/key,**10m**,"like", "error") → cerca un valor que contingui "error" dins dels darrera 10 minuts fins [ara](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<| |El primer valor (el més antic) dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int, str, text, log<br><br>Exemple:< br>=> **first**(/host/key,**1h**) → recupera el valor més antic durant la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)<br><br> Veieu també last().| |**fuzzytime** (/host/key,sec)|<|<| |Comprovació de quant difereix el temps de l'agent passiu del temps del servidor/proxy Zabbix.|Veieu [paràmetres comuns](#common parameters).|Tipus de valors admesos: float, int<br><br>Retorna:<br>1 - La diferència entre el valor de l'element passiu (com a marca de temps) i la marca de temps del servidor/proxy Zabbix (rellotge de recollida de valors) és menor o igual a T segons<br>0 - en cas contrari<br><br>S'empra habitualment amb el 'system.localtime' (temps local del sistema) per comprovar que l'hora local és sincronitzada amb l'hora local del servidor Zabbix. *Tingueu en compte* que 'system.localtime' s'ha de configurar com a [comprovació passiva](/manual/appendix/items/activepassive#passive_checks).<br>També es pot emprar amb vfs.file.time\[/path/file ,modifica\] per comprovar que el fitxer no ha rebut actualitzacions durant molt de temps.<br><br>Exemple:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detecta un problema si la diferència de temps supera els 60 segons<br><br>Aquesta funció no es recomana emprar-la en expressions d'activació complexes (amb diversos elements implicats), perquè pot provocar resultats inesperats (la diferència de temps es mesurarà amb el mètrica més recent), p. ex. a `fuzzytime(/Host/system.localtime,60s)=0 o last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<| |El valor més recent.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent|Tipus de valors admesos: float, int, str, text, log<br><br>Tingueu en compte que un període de temps etiquetat amb hash (\#N) funciona de manera diferent aquí que a moltes altres funcions.<br>Per exemple:<br>last() sempre és igual a last(\#1)<br>darrer(\#3) - tercer valor més recent (*no* tres valors més recents)<br><br>Zabbix no garanteix l'ordre exacte dels valors si hi ha més de dos valors dins un segon a l'historial.<br><br>Exemple:<br>=> **last**(/host/key) → recupera el darrer valor<br>=> **last**(/host/key, **\#2**) → recupera el valor anterior<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key, **\#2**) → els darrers valors i els anteriors són diferents<br><br>Veieu també primer().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Comprovar si l'ID d'esdeveniment de la darrera entrada de registre coincideix amb una expressió regular.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent <br><br>**pattern** (opcional) - expressió regular que descriu el patró requerit, estil [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (els arguments de cadena han d'ésser entre cometes dobles).|Tipus de valors admesos: log<br><br>Retorna:<br>0 - no coincideix<br>1 - coincideix| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<| |Gravetat del registre de la darrera entrada del registre.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - el valor enèsim més recent|Tipus de valors admesos: registre <br><br>Retorna:<br>0 - gravetat predeterminada<br>N - gravetat (enter, útil per als registres d'esdeveniments de Windows: 1 - Informació, 2 - Avís, 4 - Error, 7 - Auditoria d'errors, 8 - Auditoria correcta, 9 - Crític, 10 - Detall).<br>Zabbix pren la gravetat del registre del camp **Information** del registre d'esdeveniments de Windows.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Comprovar si l'origen del registre de la darrera entrada del registre coincideix amb una expressió regular.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent <br><br>**pattern** (opcional) - expressió regular que descriu el patró requerit, estil [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (els arguments de cadena han d'ésser entre cometes dobles).|Tipus de valors admesos: registre<br><br>Retorna:<br>0 - no coincideix<br>1 - coincideix<br><br>S'empra normalment per als registres d'esdeveniments de Windows. Per exemple, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Comproveu si hi ha hagut una disminució monòtona dels valors.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (ha d'ésser entre cometes dobles) - *feble* (cada valor) és més petit o el mateix que l'anterior; per defecte) o *estricte* (tots els valors han disminuït)|Tipus de valors admesos: int<br><br>Retorna 1 si tots els elements del període de temps disminueixen contínuament, 0 en cas contrari.< br><br>Exemple:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/ system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calcula a quants equips hi ha hagut una disminució de la mida de l'intercanvi lliure| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Comprovar si hi ha hagut un increment monòton de valors.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (ha d'ésser entre cometes dobles) - *feble* (cada valor és més gran o el mateix que l'anterior; per defecte) o *estricte* (tots els valors han augmentat)|Tipus de valors admesos: int<br><br>Retorna 1 si tots els elements del període de temps augmenten contínuament, 0 en cas contrari.<br><br>Exemple:< br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - comproveu si l'hora local del sistema ha pujat de forma constant| |**nodata** (/host/key,sec,<mode>)|<|<| |Comprovació de no rebuda de dades.|Veieu els [paràmetres comuns](#common-parameters).<br><br>El període de **seg** no hauria d'ésser inferior a 30 segons perquè el procés de sincronització de l'historial calcula aquesta funció només cada 30 segons.<br><br>nodata(/host/key,0) no és permesa.<br><br>**mode**: si s'estableix en *estricte* (entre cometes), aquesta funció serà insensible a Disponibilitat de proxy (veieu els comentaris per obtindre més informació).|S'admeten tots els tipus de valors.<br><br>Retorna:<br>1 - si no s'han rebut dades durant el període de temps definit<br>0 - en cas contrari<br><br >Des de Zabbix 5.0, els triggers de "nodata" monitorats pel proxy són, de manera predeterminada, sensibles a la disponibilitat del proxy; si el proxy no és pas disponible, els triggers de "nodata" no s'activaran immediatament quan es restauri la connexió, sinó que saltaran les dades per als períodes endarrerits. Tingueu en compte que per als proxys passius la supressió s'activa si la connexió es restableix més de 15 segons i no menys de 2 i ProxyUpdateFrequency segons més tard. Per als proxys actius, la supressió s'activa si la connexió es restaura més de 15 segons després.<br><br>Per desactivar la sensibilitat a la disponibilitat del proxy, empreu el tercer paràmetre, p. ex.: **nodata**(/host/key,** 5m**,**"estricte"**); en aquest cas, la funció anirà igual que abans de la 5.0.0 i s'activarà tan aviat com hagi passat el període d'avaluació (cinc minuts) sense dades.<br><br>Tingueu en compte que aquesta funció mostrarà un error si, dins del període del 1r paràmetre:<br>- no hi ha dades i el servidor Zabbix s'ha reiniciat<br>- no hi ha dades i s'ha completat el manteniment<br>- no hi ha dades i l'element s'ha afegit o tornat a habilitar<br>Es mostren errors a la columna *Informació* del trigger [configuració](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>És possible que aquesta funció no funcioni correctament si hi ha diferències horàries entre el servidor Zabbix, el proxy i l'agent. Veieu també: [Requisit de sincronització de l'hora](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<| |P-è percentil d'un període, on P (percentatge) s'especifica com a tercer paràmetre.|Veieu [paràmetres comuns](#common-parameters).<br><br>**percentatge** - un nombre de coma flotant entre 0 i 100 (inclosos) amb fins a 4 dígits després del punt decimal|Tipus de valors admesos: float, int| |**tax** (/host/key,sec<:time shift>)|<|<| |Taxa mitjana per segon de l'augment d'un comptador que augmenta monòtonament dins del període de temps definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Correspon funcionalment a "[tarifa](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)" de PromQL.<br><br>Exemple:<br>=> **tarifa**(/ host/clau,**30s**) → Si l'augment monòton en 30 segons és 20, aquesta funció retornarà 0,67.|

en-us	# history.get
ca	# history.get

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 the Zabbix server and cannot be modified via the API. :::
ca	# > Objecte historial  Els objectes següents són vinculats a l'API`history`.  ::: noteclassic Els objectes d'històric difereixen segons el tipus d'informació de l'element. Es creen pel servidor Zabbix i no poden pas ésser modificats per via de l'API. :::

en-us	#### History  Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing.  [History API](/manual/api/reference/history)
ca	#### Historial  Recupera els valors de l'historial recollits per els processos de monitoratge de Zabbix per presentar-los o tractar-los posteriorment.  [API Historial](/manual/api/reference/history)

en-us	# History  This class is designed to work with history data.  Object references:\  -   [History](/manual/api/reference/history/object#history)  Available methods:\  -   [history.get](/manual/api/reference/history/get) - retrieving     history data.
ca	# Històric  Aquesta classe és pensada per treballar amb les informació de l'històric.  Referències d'objectes:\  -   [Històric](/manual/api/reference/history/object#history)  Mètodes disponibles:\  -   [history.get](/manual/api/reference/history/get) - consultar dades de l'històric.

en-us	 ### HMAC function for JavaScript  A new function has been added to the JavaScript engine allowing to return HMAC hash:  -   `hmac('<hash type>',key,string)`  This is useful for cases when hash-based message authentication code (HMAC) is required for signing requests. MD5 and SHA256 hash types are supported, e. g.:     -   `hmac('md5',key,string)`    -   `hmac('sha256',key,string)`
ca	### Funció HMAC per JavaScript  S'ha afegit una nova funció al motor JavaScript per calcular el hash HMAC:  - `hmac('<tipus hash>',clau,cadena)`  Això és útil en els casos en què es requereix un codi d'autenticació de missatges basat en hash (HMAC) per signar les peticions. S'admeten els tipus hash MD5 i SHA256, per exemple:   · - · `hmac('md5',clau,cadena)`  · - · `hmac('sha256',clau,cadena)`

en-us	#### Host access from several user groups  A user may belong to any number of user groups. These groups may have different access permissions to hosts.  Therefore, it is important to know what hosts an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B.  -   If Group A has only *Read* access to Hostgroup 1, but Group B     *Read-write* access to Hostgroup 1, the user will get **Read-write**     access to 'X'.  ::: noteimportant “Read-write” permissions have precedence over “Read” permissions starting with Zabbix 2.2. :::  -   In the same scenario as above, if 'X' is simultaneously also in     Hostgroup 2 that is **denied** to Group A or B, access to 'X' will     be **unavailable**, despite a *Read-write* access to Hostgroup 1. -   If Group A has no permissions defined and Group B has a *Read-write*     access to Hostgroup 1, the user will get **Read-write** access to     'X'. -   If Group A has *Deny* access to Hostgroup 1 and Group B has a     *Read-write* access to Hostgroup 1, the user will get access to 'X'     **denied**.
ca	#### Accés a equips des de diferents grups d'usuaris  Un usuari pot pertànyer a qualsevol nombre de grups d'usuaris. Aquests grups poden tindre diferents permisos d'accés als equips.  Per tant, és important sabre a quins equips podrà accedir un usuari sense privilegis. Per exemple, examinem com es veurà afectat l'accés a l'equip **X** (al grup d'equip 1) en diverses situacions per a un usuari que es troba als grups d'usuaris A i B.  - Si el grup A només té accés de *lectura* al grup d'equip 1, però el grup B té accés de *lectura-escriptura* al grup d'equip 1, l'usuari tindrà accés de **lectura-escriptura** a 'X'.  ::: noteimportant Els permisos de "lectura-escriptura" tenen prioritat sobre els permisos de "lectura" des de Zabbix 2.2. :::  - En el mateix escenari que l'anterior, si 'X' també es troba simultàniament al grup d'equip 2 que és **denegat** al grup A o B, l'accés a 'X' serà **no disponible** , tot i haver-hi *lectura-escriptura* al grup d'equip 1. - Si el grup A no té permisos establerts i el grup B té accés de *Lectura-Escriptura* al grup d'equip 1, l'usuari obtindrà accés de **Lectura-Escriptura** a 'X'. - Si el grup A té accés *Denegat* al grup d'equip 1 i el grup B té accés de *Lectura-Escriptura* al grup d'equip 1, l'usuari tindrà accés a 'X' **denegat**.

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.
ca	##### Configuració de l'equip  S'ha de configurar un equip per tractar les verificacions IPMI. Una interfície IPMI s'ha d'afegir, amb les adreces IP i els nombres de port respectius, i s'han de definir els paràmetres d'autenticació IPMI.  Veieu la [configuració d'equips](/manual/config/hosts/host) per tindre més detalls.

en-us	#### Host configuration  To use VMware simple checks the host must have the following user macros defined:  -   **{$VMWARE.URL}** - VMware service (vCenter or ESX hypervisor) SDK     URL (<https://servername/sdk>) -   **{$VMWARE.USERNAME}** - VMware service user name -   **{$VMWARE.PASSWORD}** - VMware service {$VMWARE.USERNAME} user     password
ca	#### Configuració de l'equip  Per emprar VMware Simple Checks, l'equip ha d'haver definit les macros d'usuari següents:  - **{$VMWARE.URL}** - URL de l'SDK del servei VMware (vCenter o hipervisor ESX) (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - Nom d'usuari del servei VMware - **{$VMWARE.PASSWORD}** - Mot de pas d'usuari del servei VMware {$VMWARE.USERNAME}

en-us	##### Host configuration  You can specify that an individual host should be monitored by a proxy in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by proxy* field.  ![](../../../assets/en/manual/proxies/proxy_set.png)  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy.
ca	##### Configuració de l'equip  Podeu especificar que un equip s'ha de monitorar a un proxy al formulari [Configuració de l'equip](/manual/config/hosts/host), emprant el camp *Monitorat mitjançant proxy*.  ![](../../../assets/en/manual/proxies/proxy_set.png)  L'[actualització massiva](/manual/config/hosts/hostupdate) dels equips pot ésser una altra manera d'especificar que els equips han d'ésser monitorats per un proxy.

en-us	# host.create
ca	# 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.
ca	##### Creació d'equip  S'afegeix un equip si és triada l'operació *Afegir equip*. També s'afegeix un equip, encara que falti l'operació *Afegir equip*, si trieu operacions que donen lloc a accions en un equip. Aquestes operacions són:  - activar equip - desactivar equip - afegir un equip a un grup d'equips - vincular un model a un equip  Els equips creats s'afegeixen al grup *Equips descoberts* (per defecte, configurable a *Administració* → *General* → *[Altres](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Si voleu que s'afegeixin equips a un altre grup, afegiu una operació *Treure dels grups d'equips* (especificant "Equips descoberts") i també una operació *Afegir als grups d'equips* (especificant un altre grup d'equips), perquè un equip ha de pertànyer a un grup d'equips.

en-us	# host.delete
ca	# host.delete

en-us	#### Host editing as popup  The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration.  Direct links to the host edit page still work and are opening the host edit page in full page.
ca	##### Modificació d'equip via popup  El formulari de creació i edició de l'equip s'obre ara en una finestra modal (pop-up), a *Configuració* → *Equips*, *Monitoratge* → *Equips*, i a qualsevol pàgina on hi hagi un menú d'equips o un altre enllaç directe a la configuració de l'equip.  Els enllaços directes a la pàgina d'edició de l'equip encara funcionen i obren la pàgina d'edició de l'equip a pantalla completa.

en-us	# host.get
ca	# host.get

en-us	##### Host graph tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |sortorder|\-|`integer`| |Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| | |drawtype|\-|`string`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.|
ca	##### Etiquetes de gràfic d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |gràfics| |\-| | |Element arrel per a gràfics.| | |name|x|`cadena`| |Nom del gràfic.| | |width|\-|`integer`|20-65535 (per defecte: 900)|Amplada del gràfic, en píxels. S'empra per a la previsualització i per a gràfics circulars/explotats.| | |height|\-|`integer`|20-65535 (per defecte: 200)|Alçada del gràfic, en píxels. S'empra per a la previsualització i per a gràfics circulars/explotats.| | |yaxismin|\-|`double`|Per defecte: 0|Valor mínim de l'eix Y.<br><br>S'empra si 'ymin\_type\_1' està FIXAT.| | |yaxismax|\-|`double`|Per defecte: 0|Valor màxim de l'eix Y.<br><br>S'empra si 'ymax\type\_1' està FIXAT.| | |show\_work\_period|\-|`cadena`|0 - NO<br>1 - SÍ (predeterminat)|Destaca les hores no treballades.<br><br>S'empren per gràfics normals i apilats. | | |show\_triggers|\-|`cadena`|0 - NO<br>1 - YES (per defecte)|Mostra els valors de trigger únics com a línia.<br><br>S'empren per gràfics normals i apilats .| | |type|\-|`cadena`|0 - NORMAL (predeterminat)<br>1 - APILAT<br>2 - PASTÍS<br>3 - EXPLOTAT|Tipus de gràfic.| | |show\_legend|\-|`cadena`|0 - NO<br>1 - SÍ (per defecte)|Mostra la llegenda del gràfic.| | |show\_3d|\-|`cadena`|0 - NO (predeterminat)<br>1 - SÍ|Activa l'estil 3D.<br><br>S'empren per gràfics de sectors i gràfics de sectors explotats. | | |percent\_left|\-|`double`|Per defecte: 0|Mostra la línia percentil per a l'eix esquerre.<br><br>Només s'empra per a gràfics normals.| | |percent\_right|\-|`double`|Per defecte: 0|Mostra la línia percentil per a l'eix dret.<br><br>Només s'empra per a gràfics normals.| | |ymin\_type\_1|\-|`cadena`|0 - CALCULAT (predeterminat)<br>1 - FIXAT<br>2 - ARTICLE|Valor mínim de l'eix Y.<br><br>Emprat amb gràfics normals i apilats.| | |ymax\_type\_1|\-|`cadena`|0 - CALCULAT (predeterminat)<br>1 - FIXAT<br>2 - ELEMENT|Valor màxim de l'eix Y.<br><br>Emprat per gràfics normals i apilats.| |ymin\_item\_1| |\-| | |Detalls de cada element.<br><br>Obligatori si 'ymin\_type\_1' és ELEMENT.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| |ymax\_item\_1| |\-| | |Detalls de cada element.<br><br>Obligatori si 'ymax\_type\_1' és ELEMENT.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| |gràfic\_elements| |x| | |Element arrel per als elements del gràfic.| | |sortorder|\-|`enter`| |Ordre de dibuix. Primer es dibuixa el valor més petit. Es pot emprar per dibuixar línies o regions darrere (o davant) d'una altra.| | |drawtype|\-|`cadena`|0 - SINGLE\_LINE (per defecte)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Estil de dibuix d'elements gràfics.<br><br>Només s'empren els gràfics normals.| | |color|\-|`cadena`| |Color de l'element (6 símbols, hexadecimal).| | |yaxisside|\-|`cadena`|0 - ESQUERRE (per defecte)<br>1 - DRET|Lateral del gràfic on es dibuixarà l'escala Y de l'element del gràfic.<br><br>S'empra a gràfics normals i apilats.| | |calc\_fnc|\-|`cadena`|1 - MIN<br>2 - AVG (predeterminat)<br>4 - MAX<br>7 - ALL (mínim, mitjà i màxim; emprat només per gràfics simples)<br>9 - LAST (emprat només per gràfics de pastís i gràfics de pastís explotats)|Dades per dibuixar si hi ha diversos valors per a un element.| | |type|\-|`cadena`|0 - SINGLE (per defecte)<br>2 - GRAPH\_SUM (el valor de l'element representa el sector sencer; només s'empren els gràfics de pastís i de pastís explotats)|Tipus d'element de gràfic.| |element| |x| | |Element individual.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.|

en-us	#### host group  Changes:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters.\
ca	#### grup d'equips  Canvis:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: els camps `hosts` i `templates` ara són necessaris.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: afegida validació estricta dels paràmetres de mètode.\

en-us	#### hostgroup  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated.\
ca	#### grup d'equips  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: el paràmetre `uuid` ara es pot actualitzar.\

en-us	# hostgroup.create
ca	# hostgroup.create

en-us	# hostgroup.delete
ca	# hostgroup.delete

en-us	# hostgroup.get
ca	# hostgroup.get

en-us	# hostgroup.massadd
ca	# hostgroup.massadd

en-us	# hostgroup.massremove
ca	# hostgroup.massremove

en-us	# hostgroup.massupdate
ca	# hostgroup.massupdate

en-us	# > Host group object  The following objects are directly related to the `hostgroup` API.
ca	# > Objecte Grup d'equips  Els següents objectes són relacionats amb l'API `hostgroup`.

en-us	### Host group  The host group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Grup d'equips  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|string|*(nomes lectura)* ID del grup d'equips.| |**name**<br>(obligatori)|string|Nom del grup d'equips.| |flags|integer|*(nomes lectura)* Origen del grup d'equips.<br><br>Valors possibles:<br>0 - un grup d'equips en brut;<br>4 - un grup d'equips descobert.| |internal|integer|*(nomes lectura)* Indica si el grup s'empra internament per al sistema. Un grup intern no pot pas esborrar-se.<br><br>Valors possibles:<br>0 - *(per defecte)* no intern;<br>1 - intern.| |uuid|string|Identificador universal únic, emprat per enllaçar els grups d'equips importats als ja existents. Generat automàticament si no es proporciona.|  Veieu que per alguns mètodes (com ara actualitzar i esborrar), la combinació de paràmetres obligatoris o opcionals és diferent.

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) -     creating new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     deleting host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving     host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adding related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removing related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     replacing or removing related objects from host groups -   [hostgroup.update](/manual/api/reference/hostgroup/update) -     updating host groups
ca	# Grup d'equips  Aquesta classe és dissenyada per treballar amb grups d'equips.  Referències d'objectes:\  -   [Grup d'equips](/manual/api/reference/hostgroup/object#host_group)  Mètodes disponibles:\  -   [hostgroup.create](/manual/api/reference/hostgroup/create) - crear grups d'equips -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) - esborrar grups d'equips -   [hostgroup.get](/manual/api/reference/hostgroup/get) - recuperar grups d'equips -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - afegir objectes als grups d'equips -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - esborrar objectes dels grups d'equips -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - reemplaçar o esborrar objectes dels grups d'equips -   [hostgroup.update](/manual/api/reference/hostgroup/update) - actualitzar grups d'equips

en-us	# hostgroup.update
ca	# hostgroup.update

en-us	# hostinterface.create
ca	# hostinterface.create

en-us	# hostinterface.delete
ca	# hostinterface.delete

en-us	# hostinterface.get
ca	# hostinterface.get

en-us	# hostinterface.massadd
ca	# hostinterface.massadd

en-us	# hostinterface.massremove
ca	# hostinterface.massremove

en-us	# > Host interface object  The following objects are directly related to the `hostinterface` API.
ca	# > Objecte interfície d'equip  Els següents objectes són enllaçats amb l'API `hostinterface`.

en-us	# hostinterface.replacehostinterfaces
ca	# hostinterface.replacehostinterfaces

en-us	### Host interface  The host interface object has the following properties.  ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|array|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|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 are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Interfície d'equip  L'objecte d'interfície d'equip té les propietats següents.  ::: nota important Tingueu en compte que cal IP i DNS. Si no s'ha d'emprar DNS, configureu-lo en una cadena buida. :::  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |available|integer|*(només lectura)*Disponibilitat de la interfície de l'equip.<br><br>Els valors possibles són:<br>0 - *(per defecte)* desconegut;<br>1 - disponible;< br>2 - no disponible.| |details|array|Objecte addicional per a la interfície. **Obligatori** si el "tipus" d'interfície és SNMP.| |disable\_until|timestamp|*(només lectura)* La propera vegada que es consulta una interfície d'equip no disponible.| |**dns**<br>(obligatori)|string|Nom DNS emprat per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant IP.| |error|string|*(només lectura)* Text d'error si la interfície de l'equip no és pas disponible.| |errors\_from|timestamp|*(només lectura)*Hora en què la interfície de l'equip no va estar disponible.| |**hostid**<br>(obligatori)|string|ID de l'equip al que pertany la interfície.| |interfaceid|string|*(només lectura)* ID de la interfície.| |**ip**<br>(obligatori)|string|adreça IP emprada per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant DNS.| |**main**<br>(obligatori)|integer|Indica si la interfície s'empra per defecte a l'equip. Només es pot configurar per defecte una interfície d'un tipus determinat en un host.<br><br>Valors possibles:<br>0 - no (per defecte);<br>1 - predeterminat.| |**port**<br>(obligatori)|string|Nombre de port emprat per la interfície. Pot contindre macros d'usuari.| |**tipus**<br>(obligatori)|integer|Tipus d'interfície.<br><br>Valors possibles:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI; <br> >4 - JMX.<br>| |**useip**<br>(obligatori)|integer|Indica si la connexió s'ha d'establir mitjançant IP.<br><br>Valors possibles:<br>0 - connecteu-vos amb el nom DNS de l'equip ;<br>1 - connecteu-vos mitjançant l'adreça IP de l'equip per a aquesta interfície d'equip.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Host interface  This class is designed to work with host interfaces.  Object references:\  -   [Host     interface](/manual/api/reference/hostinterface/object#host_interface)  Available methods:\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) -     creating new host interfaces -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) -     deleting host interfaces -   [hostinterface.get](/manual/api/reference/hostinterface/get) -     retrieving host interfaces -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) -     adding host interfaces to hosts -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) -     removing host interfaces from hosts -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) -     replacing host interfaces on a host -   [hostinterface.update](/manual/api/reference/hostinterface/update) -     updating host interfaces
ca	# Interfícies d'equips  Aquesta classe és dissenyada per treballar amb interfícies d'equips.  Referències d'objectes:\  -   [interfície d'equips](/manual/api/reference/hostinterface/object#host_interface)  Mètodes disponibles:\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) - crear interfícies d'equips -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) - esborrar interfícies d'equips -   [hostinterface.get](/manual/api/reference/hostinterface/get) - recuperar interfícies d'equips -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - afegir objectes als interfícies d'equips -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - esborrar objectes dels interfícies d'equips -   [hostinterface.replacehostinterfaces (/manual/api/reference/hostinterface/replacehostinterfaces) - reemplaçar les interfícies d'un equip -   [hostinterface.update](/manual/api/reference/hostinterface/update) - actualitzar interfícies d'equips

en-us	# hostinterface.update
ca	# hostinterface.update

en-us	### Host inventory  The host inventory object has the following properties.  ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. :::  |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters|
ca	### Inventari d'equip  L'objecte d'inventari d'equip té les propietats següents.  ::: notetip Cada propietat té el seu propi nombre d'identificació únic, que s'empra per associar camps d'inventari de l'equip amb articles. :::  |ID|Propietat|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |-|--|-|-----|-----| |4|alias|string|Àlies.|128 caràcters| |11|asset\_tag|string|Etiqueta característica.|64 caràcters| |28|chassis|string|Xassís.|64 caràcters| |23|contact|string|Persona de contacte.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |32|contract\_number|string|Nombre de contracte.|64 caràcters| |47|date\_hw\_decomm|string|Material - Data de retirada.|64 caràcters| |46|data\_hw\_expiry|string|Maquinari - Data de finalització del manteniment|64 caràcters| |45|date\_hw\_install|string|Maquinari - Data d'instal·lació.|64 caràcters| |44|data\_hw\_purchase|string|Material - Data de compra.|64 caràcters| |34|desplegament\_estat|string|Estat del desplegament.|64 caràcters| |14|hardware|string|Maquinari.|255 caràcters| |15|hardware\_full|string|Detalls complets del maquinari.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |39|host\_netmask|string|Màscara de subxarxa de l'equip.|39 caràcters| |38|host\_networks|string|Xarxes d'equip.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |40|host\_router|string|Equip - Encaminador.|39 caràcters| |30|hw\_arch|string|Arquitectura del material.|32 caràcters| |33|installer\_name|string|Nom de l'instal·lador.|64 caràcters| |24|location|string|Ubicació.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |25|location\_lat|string|Latitud de la ubicació.|16 caràcters| |26|location\_lon|string|Longitud de la ubicació.|16 caràcters| |12|macaddress\_a|string|adreça MAC A.|64 caràcters| |13|macaddress\_b|string|adreça MAC B.|64 caràcters| |29|model|string|Model.|64 caràcters| |3|name|string|Nom.|128 caràcters| |27|notes|string|Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |41|oob\_ip|string|Adreça IP OOB.|39 caràcters| |42|oob\_netmask|string|Màscara de subxarxa OOB.|39 caràcters| |43|oob\_router|string|OOB de l'encaminador.|39 caràcters| |5|os|string|OS.|128 caràcters| |6|os\_full|string|Nom complet del sistema operatiu.|255 caràcters| |7|os\_short|string|Nom curt del SO.|128 caràcters| |61|poc\_1\_cell|string|Contacte principal - mòbil.|64 caràcters| |58|poc\_1\_email|string|Contacte principal - Correu electrònic.|128 caràcters| |57|poc\_1\_name|string|Contacte principal - Nom.|128 caràcters| |63|poc\_1\_notes|string|Contacte principal - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |59|poc\_1\_phone\_a|string|Contacte principal - Telèfon 1.|64 caràcters| |60|poc\_1\_phone\_b|string|Contacte principal - Telèfon 2.|64 caràcters| |62|poc\_1\_screen|string|Contacte principal - Nom d'usuari.|64 caràcters| |68|poc\_2\_cell|string|Contacte secundari - Mòbil.|64 caràcters| |65|poc\_2\_email|string|Contacte secundari - Correu electrònic.|128 caràcters| |64|poc\_2\_name|string|Contacte secundari - Nom.|128 caràcters| |70|poc\_2\_notes|string|Contacte secundari - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |66|poc\_2\_phone\_a|string|Contacte secundari - Telèfon 1.|64 caràcters| |67|poc\_2\_phone\_b|string|Contacte secundari - Telèfon 2.|64 caràcters| |69|poc\_2\_screen|string|Contacte secundari - ID.|64 caràcters| |8|serialno\_a|string|Nombre de sèrie A.|64 caràcters| |9|serialno\_b|string|Nombre de sèrie B.|64 caràcters| |48|site\_address\_a|string|Lloc - Adreça 1.|128 caràcters| |49|site\_address\_b|string|Lloc - Adreça 2.|128 caràcters| |50|site\_address\_c|string|Lloc - Adreça 3.|128 caràcters| |51|site\_city|string|Lloc - Ciutat.|128 caràcters| |53|lloc\_country|string|Lloc - País.|64 caràcters| |56|lloc\_notes|string|Lloc - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |55|site\_rack|string|Lloc - Ubicació del bastidor.|128 caràcters| |52|lloc\_state|string|Lloc - estat/província.|64 caràcters| |54|site\_zip|string|Lloc - codi postal.|64 caràcters| |16|software|string|Programari.|255 caràcters| |18|software\_app\_a|string|Aplicació de programari A.|64 caràcters| |19|software\_app\_b|string|Aplicació de programari B.|64 caràcters| |20|software\_app\_c|string|Aplicació de programari C.|64 caràcters| |21|software\_app\_d|string|Aplicació de programari D.|64 caràcters| |22|software\_app\_e|string|Aplicació de programari E.|64 caràcters| |17|software\_full|string|Detalls del programari.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |10|tag|string|Etiqueta.|64 caràcters| |1|type|string|Tipus.|64 caràcters| |2|type\_full|string|Detalls del tipus.|64 caràcters| |35|url\_a|string|URL A.|255 caràcters| |36|url\_b|string|URL B.|255 caràcters| |37|url\_c|string|URL C.|255 caràcters| |31|vendor|string|Proveïdor.|64 caràcters|

en-us	##### Host item tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |items| |\-| | |Root element for items.| | |name|x|`string`| |Item name.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| | |snmp\_oid|\-|`string`| |SNMP object ID.<br><br>Required by SNMP items.| | |key|x|`string`| |Item key.| | |delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| | |history|\-|`string`|Default: 90d|Time period of how long the history data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |trends|\-|`string`|Default: 365d|Time period of how long the trends data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| | |value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| | |allowed\_hosts|\-|`string`| |List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| | |units|\-|`string`| |Units of returned values (bps, B, etc).| | |params|\-|`text`| |Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| | |ipmi\_sensor|\-|`string`| |IPMI sensor.<br><br>Used only by IPMI items.| | |authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| | |username|\-|`string`| |Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| | |password|\-|`string`| |Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| | |publickey|\-|`string`| |Name of the public key file.<br><br>Required for SSH agent items.| | |privatekey|\-|`string`| |Name of the private key file.<br><br>Required for SSH agent items.| | |description|\-|`text`| |Item description.| | |inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| | |logtimefmt|\-|`string`| |Format of the time in log entries.<br>Used only by log items.| | |interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| | |jmx\_endpoint|\-|`string`| |JMX endpoint.<br><br>Used only by JMX agent items.| | |url|\-|`string`| |URL string.<br><br>Required only for HTTP agent items.| | |allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while polling data.<br><br>Used only by HTTP agent items.| |headers| |\-| | |Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |http\_proxy|\-|`string`| |HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| | |output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| | |post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| | |posts|\-|`string`| |HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields| |\-| | |Root element for query parameters.<br><br>Used only by HTTP agent items.| | |name|x|`string`| |Parameter name.| | |value|\-|`string`| |Parameter value.| | |request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| | |ssl\_cert\_file|\-|`string`| |Public SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_file|\-|`string`| |Private SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_password|\-|`string`| |Password for SSL Key file.<br><br>Used only by HTTP agent items.| | |status\_codes|\-|`string`| |Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| | |timeout|\-|`string`| |Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Used only by HTTP agent items.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters| |\-| | |Root element for user-defined parameters.<br><br>Used only by Script items.| | |name|x|`string`| |Parameter name.<br><br>Used only by Script items.| | |value|\-|`string`| |Parameter value.<br><br>Used only by Script items.| |value map| |\-| | |Value map.| | |name|x|`string`| |Name of the value map to use for the item.| |preprocessing| |\-| | |Root element for item value preprocessing.| |step| |\-| | |Individual item value preprocessing step.| | |type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| | |parameters|\-| | |Root element for parameters of the item value preprocessing step.| | |parameter|x|`string`| |Individual parameter of the item value preprocessing step.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| | |error\_handler\_params|\-|`string`| |Error handler parameters used with 'error\_handler'.| |master\_item| |\-| | |Individual item master item.<br><br>Required by dependent items.| | |key|x|`string`| |Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers| |\-| | |Root element for simple triggers.| | |*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Root element for item tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.|
ca	##### Etiquetes d'element d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |items| |\-| | |Element arrel dels elements.| | |name|x|`cadena`| |Nom de l'element.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (per defecte)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERN<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERN <br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULAT<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT <br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Tipus d'element.| | |snmp\_oid|\-|`cadena`| |ID d'objecte SNMP.<br><br>Requerit pels elements SNMP.| | |key|x|`cadena`| |Clau d'element.| | |delay|\-|`cadena`|Per defecte: 1m|Interval d'actualització de l'element.<br><br>Tingueu en compte que el `retard` sempre serà '0' per als elements trapper.<br> <br>Accepta segons o unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com a programació.<br> Diversos intervals es separen per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten múltiples macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).| | |history|\-|`string`|Per defecte: 90d|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'historial. Unitat de temps amb sufix, macro d'usuari o macro LLD.| | |trends|\-|`string`|Per defecte: 365d|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendència. Unitat de temps amb sufix, macro d'usuari o macro LLD.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'element.| | |value\_type|\-|`cadena`|0 - FLOAT<br>1 - CHAR<br>2 - REGISTR<br>3 - SIN signa (per defecte)<br>4 - TEXT|Tipus de valor rebut.| | |allowed\_hosts|\-|`cadena`| |Llista d'adreces IP (separades per comes) dels equips amb permís per enviar dades de l'element.<br><br>Emprat pels elements de trapper i d'agent HTTP.| | |units|\-|`cadena`| |Unitats de valors retornats (bps, B, etc).| | |params|\-|`text`| |Paràmetres addicionals segons el tipus d'element:<br>- script executat per a elements Script, SSH i Telnet;<br>- Consulta SQL per a elements del monitor de base de dades;<br>- fórmula per als elements calculats.| | |ipmi\_sensor|\-|`cadena`| |Sensor IPMI.<br><br>Ús només per elements IPMI.| | |authtype|\-|`string`|Tipus d'autenticació per als elements de l'agent SSH:<br>0 - MOT DE PAS (per defecte)<br>1 - PUBLIC\_KEY<br><br>Tipus d'autenticació per als elements de l'agent HTTP:<br> 0 - CAP (per defecte)<br>1 - BÀSICA<br>2 - NTLM|Tipus d'autenticació.<br><br>Només l'empren els elements de l'agent SSH i HTTP.| | |username|\-|`cadena`| |Nom d'usuari per a l'autenticació.<br>Emprat per elements d'agent de simple comprovació, SSH, Telnet, Database Monitor, JMX i HTTP.<br><br>Requerit per elements SSH i Telnet. <br>Quan l'empra l'agent JMX, el mot de pas també s'ha d'especificar amb el nom d'usuari o les dues propietats s'han de deixar en blanc.| | |password|\-|`cadena`| |Mot de pas per a l'autenticació.<br>S'empra per comprovació simple, SSH, Telnet, monitor de base de dades, elements de l'agent JMX i HTTP.<br><br>Quan l'empra l'agent JMX, el nom d'usuari també s'ha d'especificar amb el mot de pas o ambdues propietats s'han de deixar en blanc.| | |publickey|\-|`cadena`| |Nom del fitxer de clau pública.<br><br>Requerit per als elements de l'agent SSH.| | |privatekey|\-|`cadena`| |Nom del fitxer de clau privada.<br><br>Requerit per als elements de l'agent SSH.| | |description|\-|`text`| |Descripció de l'element.| | |inventory\_link|\-|`string`|0 - CAP<br><br>El nom del camp d'inventari de l'equip en majúscula. Per exemple:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Camp d'inventari de l'equip ocupat per element.<br><br>Informe: aneu a la [pàgina de l'inventari d'equip](/manual/api/reference/host/object#host_inventory) per obtindre una llista de camps d'inventari d'equip admesos i els seus ID. | | |logtimefmt|\-|`cadena`| |Format d'hora a les entrades de registre.<br>Ús només pels elements de registre.| | |interface\_ref|\-|`cadena`|Format: `if<N>`|Referència a la interfície de l'equip.| | |jmx\_endpoint|\-|`cadena`| |Punt final JMX.<br><br>Només l'empren els elements de l'agent JMX.| | |url|\-|`cadena`| |Cadena d'URL.<br><br>Només cal per als elements de l'agent HTTP.| | |allow\_traps|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Permet que el valor s'ompli com en un element de trapper.<br><br>Emprat només amb elements de l'agent HTTP.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - SÍ (per defecte)|Seguiu les redireccions de resposta HTTP quan s'afegeixin dades.<br><br>Només s'empren els elements de l'agent HTTP.| |headers| |\-| | |L'element arrel per a les capçaleres de peticions HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br>Només l'empren els elements de capçalera d'Agent HTTP.| | |name|x|`cadena`| |Nom de la capçalera.| | |value|x|`cadena`| |Valor de la capçalera.| | |http\_proxy|\-|`cadena`| |Cadena de connexió del proxy HTTP(S).<br><br>Només s'empren els elements de l'agent HTTP.| | |output\_format|\-|`string`|0 - RAW (predeterminat)<br>1 - JSON|Com processar la resposta.<br><br>Ús només pels elements de l'agent HTTP.| | |post\_type|\-|`string`|0 - RAW (predeterminat)<br>2 - JSON<br>3 - XML|Tipus de cos de dades de publicació.<br><br>Només s'empren els elements de l'agent HTTP.| | |posts|\-|`cadena`| |Dades del cos de la petició HTTP(S).<br><br>Només s'empren els elements de l'agent HTTP.| |query\_fields| |\-| | |Element arrel per als paràmetres de consulta.<br><br>Només l'empren els elements de l'agent HTTP.| | |name|x|`cadena`| |Nom del paràmetre.| | |value|\-|`cadena`| |Valor del paràmetre.| | |request\_method|\-|`string`|0 - GET (per defecte)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Mètode de petició.<br><br>Ús només per elements d'agent HTTP.| | |retrieve\_mode|\-|`string`|0 - COS (per defecte)<br>1 - CAPÇALERA<br>2 - AMBDÓS|Quina part de la resposta s'ha d'emmagatzemar.<br><br>Ús només per elements de l'agent HTTP.| | |ssl\_cert\_file|\-|`cadena`| |Camí al fitxer de clau SSL pública.<br><br>Només l'empren els elements de l'agent HTTP.| | |ssl\_key\_file|\-|`cadena`| |Camí al fitxer de clau SSL privada.<br><br>Només l'empren els elements de l'agent HTTP.| | |ssl\_key\_password|\-|`cadena`| |Mot de pas per al fitxer de clau SSL.<br><br>Només l'empren els elements de l'agent HTTP.| | |status\_codes|\-|`cadena`| |Intervals de codis d'estat HTTP obligatoris separats per comes. Admet macros d'usuari.<br>Exemple: 200.200-{\$M},{\$M},200-400<br><br>Només l'empren els elements de l'agent HTTP.| | |timeout|\-|`cadena`| |Temps d'espera de la petició de consulta de dades d'element. Admet macros d'usuari.<br><br>Emprat per l'agent HTTP i els elements d'script.| | |verify\_host|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Valida si el nom d'equip de la connexió coincideix amb el nom del certificat d'equip.<br><br>Ús només pels elements de l'agent HTTP.| | |verify\_peer|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Valida si el certificat de l'equip és autèntic.<br><br>Només l'empra l'agent HTTP dels iguals.| |parameters| |\-| | |Element arrel per als paràmetres definits per l'usuari.<br><br>Només l'empren els elements de l'script.| | |name|x|`cadena`| |Nom del paràmetre.<br><br>Només l'empren els elements de l'script.| | |value|\-|`cadena`| |Valor del paràmetre.<br><br>Només l'empren els elements de l'script.| |value map| |\-| | |Coincidència de valors.| | |name|x|`cadena`| |Nom del mapa de valors que s'emprarà per a l'element.| |preprocessing| |\-| | |Element arrel per al preprocessament del valor de l'element.| |step| |\-| | |Passa de preprocessament del valor d'element individual.| | |type|x|`string`|1 - MULTIPLICADOR<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculat com a (valor rebut-valor anterior))<br>10 - CHANGE\_PER\_SECOND (calculat com a (valor valor rebut-anterior)/(hora actual-hora de darrera comprovació))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DESCART\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Tipus de passa de preprocessament del valor de l'element.| | |parameters|\-| | |Element arrel per als paràmetres de la passa de preprocessament del valor de l'element.| | |parameter|x|`cadena`| |Paràmetre individual de la passa de preprocessament del valor de l'element.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (per defecte)<br>1 - DESCART\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Tipus d'acció a emprendre si la passa de preprocessament falla.| | |error\_handler\_params|\-|`cadena`| |Paràmetres del gestor d'errors emprats amb 'error\_handler'.| |master\_item| |\-| | |Element individual de l'element principal.<br><br>Requerit pels elements dependents.| | |key|x|`cadena`| |Valor clau de l'element principal de l'element dependent.<br><br>Es permet la recursió fins a 3 elements dependents i un nombre màxim d'elements dependents igual a 29.999.| |triggers| |\-| | |Element arrel per a triggers simples.| | |*Per als valors de l'etiqueta de trigger, veieu [etiquetes de trigger d'equips](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Element arrel per a les etiquetes d'elements.| | |tag|x|`cadena`| |Nom de l'etiqueta.| | |value|\-|`cadena`| |Valor de l'etiqueta.|

en-us	##### Host low-level discovery rule tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.|
ca	##### Etiquetes de regla de descoberta de baix nivell  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Element arrel per a regles de descoberta de baix nivell.| | |*Per a la majoria dels valors de l'etiqueta d'element, consulteu els valors de l'etiqueta d'element per a un element estàndard. A continuació només es descriuen les etiquetes específiques de les regles de descoberta de baix nivell.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (per defecte)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERN<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERN <br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Tipus d'element.| | |lifetime|\-|`string`|Per defecte: 30d|Període després del qual s'esborraran els elements que no es trobn. Segons, unitat de temps amb sufix o macro d'usuari.| |filter| | | | |Filtre individual.| | |evaltype|\-|`string`|0 - I\_O (per defecte)<br>1 - I<br>2 - O<br>3 - FORMULA|Lògica que s'empra per comprovar les condicions de filtre de les regles de descoberta de baix nivell.| | |formula|\-|`cadena`| |Fórmula de càlcul personalitzada per a condicions de filtre.| |conditions| |\-| | |Element arrel per a condicions de filtre.| | |macro|x|`cadena`| |Nom de la macro de descoberta de baix nivell.| | |value|\-|`cadena`| |Valor del filtre: expressió regular o expressió regular global.| | |operator|\-|`string`|8 - MATCHES\_REGEX (per defecte)<br>9 - NOT\_MATCHES\_REGEX|Operador de condició.| | |formulaid|x|`caràcter`| |ID únic arbitrari emprat per fer referència a una condició de l'expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho demani més endavant.| |lld\_macro\_paths| |\-| | |Element arrel per a camins de macro LLD.| | |lld\_macro|x|`cadena`| |Nom de la macro de descoberta de baix nivell.| | |path|x|`cadena`| |Selector de valors que s'assignarà a la macro corresponent.| |preprocessing| |\-| | |Preprocessament del valor de la regla LLD.| |step| |\-| | |Passa de preprocessament del valor de la regla LLD individual.| | |*Per a la majoria dels valors de l'etiqueta d'element, consulteu Valors de l'etiqueta d'element per al preprocessament del valor de l'element equip. Tot seguit es descriuen les etiquetes específiques per al preprocessament de valors de descoberta de baix nivell.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Tipus de passa de preprocessament del valor de l'element.| |trigger\_prototypes| |\-| | |Element arrel per a prototips de triggers.| | |*Per als valors de l'etiqueta d'element del prototip de trigger, consulteu les etiquetes habituals [trigger d'equip](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |graph\_prototypes| |\-| | |Element arrel per a prototips de gràfics.| | |*Per als valors de l'etiqueta d'elements de gràfic prototip, veieu les etiquetes de [gràfics d'equip](/manual/xml_export_import/hosts#host_graph_tags).*| | | | | |host\_prototypes| |\-| | |Element arrel per a prototips d'equips.| | |*Per als valors de l'etiqueta d'element del prototip d'amfitrió, vegeu les etiquetes habituals [host](/manual/xml_export_import/hosts#host_tags).*| | | | | |item\_prototypes| |\-| | |Element arrel per a prototips d'elements.| | |*Per als valors de l'etiqueta d'element del prototip d'element, consulteu les etiquetes [element d'equip](/manual/xml_export_import/hosts#host_item_tags).*| | | | | |master\_item| |\-| | |Prototip d'element individual Element mestre/Dades de prototip d'element.| | |key|x|`cadena`| |Valor clau de l'element principal del prototip d'element dependent/prototip d'element.<br><br>Requerit per a un element dependent.|

en-us	### Host macro  The host macro object defines a macro available on a host, host prototype or template. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostmacroid|string|*(readonly)* ID of the host macro.| |**hostid**<br>(required)|string|ID of the host that the macro belongs to.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Macro d'equip  L'objecte defineix una macro disponible a un equip, prototip d'equip o plantilla. Té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostmacroid|string|*(només lectura)* ID de la macro d'equip.| |**hostid**<br>(obligatori)|string|ID de l'equip a qui pertany la macro.| |**macro**<br>(obligatori)|string|Cadena de la macro.| |**valor**<br>(obligatori)|string|Valor de la macro.| |type|integer|Tipus de la macro.<br><br>Valors possibles:<br>0 - *(per defecte)* Text de la macro;<br>1 - Macro secreta;<br>2 - Secret de caixa de cabals.| |description|string|Descripció de la macro.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)
ca	Els marcadors d'equips que es mostren al mapa tenen el color del problema més greu de l'equip i el color verd si un equip no té cap problema. Si feu clic a un marcador d'equip, es mostra el nom visible de l'equip i el nombre de problemes no resolts agrupats per gravetat. Si feu clic al nom visible, s'obrirà el [menú de l'equip](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Els equips que es mostren al mapa es poden filtrar per la gravetat del problema. Toqueu la icona de filtre a l'extrem superior dret del giny i marqueu la gravetat que considereu.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)

en-us	# host.massadd
ca	# host.massadd

en-us	# host.massremove
ca	# host.massremove

en-us	# host.massupdate
ca	# host.massupdate

en-us	#### Host menu  Clicking on a host in the *Problems* widget brings up the host menu. It includes links to host inventory, latest data, problems, graphs, dashboards, web scenarios and configuration. Note that host configuration is available for Admin and Superadmin users only.  ![](../../../../../assets/en/manual/web_interface/host_menu.png)  [Global scripts](/manual/web_interface/frontend_sections/administration/scripts) can also be run from the host menu. These scripts need to have their scope defined as 'Manual host action' to be available in the host menu.  The host menu is accessible by clicking on a host in several other frontend sections:  -   Monitoring → [Problems](problems) -   Monitoring → [Problems](problems) → Event details -   Monitoring → [Hosts](hosts) -   Monitoring → Hosts → [Web     Monitoring](/manual/web_interface/frontend_sections/monitoring/hosts/web) -   Monitoring → [Latest data](latest_data) -   Monitoring → [Maps](maps) -   Reports → [Triggers top     100](/manual/web_interface/frontend_sections/reports/triggers_top)
ca	#### Menú equips  Si feu clic a un equip al giny *Problemes*, s'obre el menú d'equips. Inclou enllaços a l'inventari d'allotjament, dades més recents, problemes, gràfics, taulers, escenaris web i configuració. Tingueu en compte que la configuració de l'equip només és disponible per als usuaris administradors i superadministradors.  ![](../../../../../assets/en/manual/web_interface/host_menu.png)  També es poden executar [Guions globals](/manual/web_interface/frontend_sections/administration/scripts) des del menú de l'equip. Aquests scripts han de tindre el seu abast definit a "Acció manual de l'equip" perquè estiguin disponibles al menú de l'equip.  Es pot accedir al menú de l'equip fent clic a un equip en diverses altres seccions de la interfície:  - Monitoratge → [Problemes](problems) - Monitoratge → [Problemes](problems) → Detalls de l'esdeveniment - Monitoratge → [Equips](hosts) - Monitoratge → Equips → [Web](/manual/web_interface/frontend_sections/monitoring/hosts/web) - Monitoratge → [Darreres dades](latest_data) - Monitoratge → [Mapes](maps) - Informes → [Els 100 triggers principals](/manual/web_interface/frontend_sections/reports/triggers_top)

en-us	##### Hostname parameter  To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend.  The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified.  The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key. For Windows, it returns result of the gethostname() function, which queries namespace providers to determine the local host name. If no namespace provider responds, the NetBIOS name is returned.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified, the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The "system.hostname" key supports two optional parameters - *type* and *transform*.  *Type* parameter determines the type of the name the item should return. Supported values:  -   *netbios* (default) - returns the NetBIOS host name which is limited     to 15 symbols and is in the UPPERCASE only; -   *host* - case-sensitive, returns the full, real Windows host name (without a domain); -   *shorthost* (supported since Zabbix 5.4.7) - returns part of the     hostname before the first dot. It will return a full string if the     name does not contain a dot.  *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values:  -   *none* (default) - use the original letter case; -   *lower* - convert the text into lowercase.  So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used.  1.  leave **Hostname** or **HostnameItem** parameters undefined and     Zabbix agent will use NetBIOS host name as the hostname; 2.  leave **Hostname** parameter undefined and define **HostnameItem**     like this:\     **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use     the full, real (case sensitive) Windows host name as the hostname\     **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix     agent to use only part of the hostname before the first dot,     converted into lowercase.  Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name.
ca	##### Paràmetre Hostname  Per fer [verificacions actives](/manual/appendix/items/activepassive#active_checks) d'un equip, l'agent Zabbix ha de definir el nom de l'equip. A més, el valor del nom d'equip definit ha de ser el mateix que el "[Nom d'equip](/manual/config/hosts/host)" configurar per l'equip a la interfície.  El valor del nom d'equip de la banda de l'agent es pot definir amb el paràmetre **Hostname** o **HostnameItem**, a l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) de l'agent - o els valors per defecte s'empren si cap paràmetre és especificat.  El valor per defecte del paràmetre **HostnameItem** és el valor reenviat per la clau de l'agent "system.hostname". Per Windows, reenvia el resultat de la funció gethostname(), qui demana els proveïdors d'espais de noms per determinar el nom d'equip local. si cap proveïdor de noms respon, enviarà el nom NetBIOS.  El valor per defecte de **Hostname** és el valor reenviat per el paràmetre **HostnameItem**. Per tant, si aquests dos paràmetres no són pas especificats, el nom d'equip real serà el nom NetBIOS de l'equip; i l'agent Zabbix emprarà el nom d'equip NetBIOS per recuperar la llista de verificacions actives del servidor Zabbix i enviar-li els resultats.  La clau "system.hostname" suporta dos paràmtres opcionals - *type* i *transform*.  El paràmetre *Type* determina el tipus de nom que l'element ha d'enviar. Valors admesos:  -   *netbios* (per defecte) - retorna el nom d'equip NetBIOS, limitat a 15 símbols i només en MAJÚSCULES; -   *host* - sensible a majúscules i minúscules, retorna el nom real d'equip Windows sencer (sense domini); -   *shorthost* (suportat des de Zabbix 5.4.7) - retorna una part del nom d'equip abans del primer punt. Retornarà una cadena sencera si el nom no té cap punt.  El paràmetre *transform* es suporta des de Zabbix 5.4.7 i permet especificar una regla de transformació addicional per al nom d'equip. Valors admesos:  -   *none* (per defecte) - empra el text original, em majúscules o minúscules; -   *lower* - converteix el text a minúscules.  Per tant, per simplificar la configuració de l'arxiu zabbix\_agentd.conf i unificar, es poden emprar dues maneres diferents.  1.  deixar els paràmetres **Hostname** o **HostnameItem** sense definir i l'agent Zabbix emprarà el nom d'equip NetBIOS com a nom d'equip; 2.  deixar el paràmetre **Hostname** sense definir i definir **HostnameItem** així:\ **HostnameItem=system.hostname\[host\]** - perquè l'agent Zabbix empri el nom d'equip Windows sencer i real (sensible a majúscules i minúscules) com a nom d'equip\ **HostnameItem=system.hostname\[shorthost,lower\]** - perquè l'agent Zabbix només empri una part del nom d'equip abans del primer punt, convertit a minúscules.  El nom d'equip s'empra igualment al quadre del nom de servei Windows que s'empra per instal·lar, aturar, engegar i desinstal·lar el servei Windows. Per exemple, si l'arxiu de configuració de l'agent Zabbix especifica `Hostname=Windows_db_server`, llavors l'agent s'instal·larà com a servei Windows "`Zabbix Agent [Windows_db_server]`". Per tant, per tindre un nom de servei Windows diferent per cada instància d'agent Zabbix, cada instància ha d'emprar un nom d'equip diferent.

en-us	##### Host naming  When adding hosts, a host name is the result of reverse DNS lookup or IP address if reverse lookup fails. Lookup is performed from the Zabbix server or Zabbix proxy, depending on which is doing the discovery. If lookup fails on the proxy, it is not retried on the server. If the host with such a name already exists, the next host would get **\_2** appended to the name, then **\_3** and so on.  It is also possible to override DNS/IP lookup and instead use an item value for host name, for example:  -   You may discover multiple servers with Zabbix agent running using a     Zabbix agent item for discovery and assign proper names to them     automatically, based on the string value returned by this item -   You may discover multiple SNMP network devices using an SNMP agent     item for discovery and assign proper names to them automatically,     based on the string value returned by this item  If the host name has been set using an item value, it is not updated during the following discovery checks. If it is not possible to set host name using an item value, default value (DNS name) is used.  If a host already exists with the discovered IP address, a new host is not created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host.
ca	##### Nomenament de l'equip  Quan s'afegeixen equips, un nom d'equip és el resultat d'una cerca DNS inversa o una adreça IP si la cerca inversa falla. La cerca es realitza des del servidor Zabbix o des del proxy Zabbix, depenent de quina és fent la descoberta. Si la cerca falla al proxy, no es torna a provar al servidor. Si l'equip amb aquest nom ja existeix, el següent equip tindrà **_2** afegit al nom, després **_3** i així successivament.  També és possible anul·lar la cerca DNS/IP i emprar un valor d'element per al nom d'equip, per exemple:  - Podeu descobrir diversos servidors amb l'agent Zabbix en execució mitjançant un element d'agent Zabbix per a la descoberta i assignar-los automàticament noms propis, en funció del valor de cadena que retorna aquest element - Podeu descobrir diversos dispositius de xarxa SNMP mitjançant un element d'agent SNMP per a la descoberta i assignar-los automàticament noms propis, en funció del valor de cadena que retorna aquest element  Si el nom d'equip es va establir amb un valor d'element, no s'actualitzarà en comprovacions de descoberta posteriors. Si no és possible establir el nom d'equip mitjançant un valor d'element, s'empra el valor per defecte (nom DNS).  Si ja existeix un equip amb l'adreça IP descoberta, no s'en crea cap de nou. Tanmateix, si l'acció de descoberta conté operacions (enllaç a una plantilla, afegir a un grup d'equip, etc.), es realitzen a l'equip existent.

en-us	# > Host object  The following objects are directly related to the host API.
ca	# > Objecte equip  Els següents objectes són relacionats amb l'API d'equip.

en-us	#### host prototype  Changes:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: dropped support of properties `group_prototypeid`, `hostid`, `templateid` of group link and group prototype API objects.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: dropped the ability to modify the readonly fields `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` of inherited host prototypes.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: added strict validation of the method parameters.\
ca	#### Prototipus d'equip  Canvis :\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: es deixa de suportar les propietats `group_prototypeid`, `hostid`, `templateid` dels objetes API dels enllaços i prototips de grups.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: es treu la possibilitat de modificar els camps de només lectura `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` dels prototipus d'equips heretats.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: afegida una validació estricta dels paràmetres del mètode.\

en-us	#### hostprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated.\
ca	#### prototip d'equips  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: el paràmetre `uuid` ara es pot actualitzar.\

en-us	# hostprototype.create
ca	# hostprototype.create

en-us	# hostprototype.delete
ca	# hostprototype.delete

en-us	# hostprototype.get
ca	# hostprototype.get

en-us	# > Host prototype object  The following objects are directly related to the `hostprototype` API.
ca	# > Objecte prototip d'equips  Els següents objectes són relacionats amb l'API `hostprototype`.

en-us	#### Host prototypes  Host prototypes can be created with the low-level discovery rule. When virtual machines  are discovered, these prototypes are the basis for generating real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png){width="600"}  In order for hosts created from a prototype to have unique host names, the *Host name* field must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros).  Since Zabbix 5.2, discovered hosts may be configured with custom interfaces or inherit the IP of a host the discovery rule belongs to (default). To add one or more custom interface, switch the *Interface* selector from *Inherit* to *Custom* mode, then press ![add\_link.png](../../assets/en/manual/config/add_link.png) and select the required interface type from the drop-down menu that appears. All supported types of interfaces can be defined for a host prototype: Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros). If several custom interfaces are specified - use the *Default* column to specify the primary interface.  Notes:  -   If *Custom* is selected, but no interfaces have been specified the     hosts will be created without interfaces. -   If *Inherit* is selected for a host prototype that belongs to a     template, discovered hosts will inherit the interface of a host to     which the template is linked to.  ::: notewarning  A host will not be created, if the host interface contains incorrect data  :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  LLD macros can also be used for the visible name, host group prototype fields, tag values, or values of host prototype user macros.  Other options that can be specified for a host prototype are:  -   Linkage to existing host groups -   Template linkage -   Encryption  If *Create enabled* is checked, the host will be added in an enabled state. If unchecked, the host will be added, but in a disabled state.  If *Discover* is checked (default), the host will be created. If unchecked, the host will not be created, unless this setting is overridden in the [discovery rule](/manual/discovery/low_level_discovery#override). This functionality provides additional flexibility when creating discovery rules.  Discovered hosts are prefixed with the name of the discovery rule that created them, in the host list. Discovered hosts can be manually deleted. Discovered hosts will also be automatically deleted, based on the *Keep lost resources period (in days)* value of the discovery rule. Most of the configuration options are read-only, except for enabling/disabling the host and host inventory.  ::: noteclassic Zabbix does not support nested host prototypes, i.e. host prototypes are not supported on hosts that are discovered by low-level discovery rule. :::
ca	#### Prototips d'equips  Els prototips d'equips es poden crear amb la regla de descoberta de baix nivell. Quan es descobreixen màquines virtuals, aquests prototips es converteixen en equips reals. Els prototips, abans de ser trobats, no poden tindre els seus propis elements i triggers, excepte els de les plantilles enllaçades. Els equips trobats pertanyeran a un equip existent.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png){width="600"}  Perquè els equips creats a partir d'un prototip tinguin noms d'equip únics, el camp *Nom d'equip* ha de contindre almenys una [macro de descoberta de baix nivell](/manual/config/macros/lld_macros).  Des de Zabbix 5.2, els equips descoberts es poden configurar amb interfícies personalitzades o heretar la IP d'un equip al qual pertany la regla de descoberta (per defecte). Per afegir una o més interfícies personalitzades, canvieu el selector *Interfície* del mode *Heretar* al mode *Personalitzat* i, a continuació, premeu ![add\_link.png](../../assets/en/manual/config/add_link .png) i trieu el tipus d'interfície requerit al menú desplegable que apareix. Tots els tipus d'interfícies compatibles es poden definir per a un prototip d'equip: agent Zabbix, SNMP, JMX, IPMI. Els camps de la interfície admeten macros de descoberta de baix nivell i [macros d'usuari](/manual/config/macros/user_macros). Si s'especifiquen diverses interfícies personalitzades, empreu la columna *Predeterminada* per especificar la interfície principal.  Notes:  - Si es tria *Personalitzar*, però no s'ha especificat cap interfície, els equips es crearan sense interfícies. - Si es tria *Heretar* per a un prototip d'equip que pertany a una plantilla, els equips descoberts heretaran la interfície d'un equip al qual la plantilla és enllaçada.  ::: notewarning   No es crearà cap equip si la interfície de l'equip conté dades incorrectes :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  Les macros LLD també es poden emprar per al nom visible, els camps del prototip del grup d'equip, els valors de l'etiqueta o els valors de les macros d'usuari del prototip de l'equip.  Altres opcions que es poden especificar per a un prototip d'equip són:  - Enllaç amb grups d'acollida existents - Enllaç de plantilles - Xifrat  Si s'ha marcat *Crear activat*, l'equip s'afegirà en estat habilitat. Si no és marcat, s'afegirà l'equip, però en un estat desactivat.  Si és marcat *Descoberta* (per defecte), es crearà l'equip. Si no és marcat, l'equip no es crearà, tret que aquesta configuració es substitueixi a la [regla de descoberta](/manual/discovery/low_level_discovery#override). Aquesta funcionalitat proporciona flexibilitat addicional a l'hora de crear regles de descoberta.  Els equips descoberts tenen com a prefix el nom de la regla de descoberta que els ha creat, a la llista d'equips. Els equips descoberts es poden esborrar manualment. Els equips descoberts també s'esborraran automàticament, en funció del valor de la regla de descoberta *Conservar el període de recursos perduts (en dies)*. La majoria de les opcions de configuració són de només lectura, tret d'activar/desactivar l'inventari de l'equip i l'equip.  ::: noteclassic Zabbix no admet prototips d'equip heretats, és a dir, els prototips d'equip no s'admeten als equips que es troben per regla de descoberta de baix nivell. :::

en-us	### Host prototype tag  The host prototype tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.|
ca	### Etiqueta de prototip d'equips  L'objecte d'etiqueta de prototip d'equips té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta de prototip d'equips.| |value|string|Valor de l'etiqueta de prototip d'equips.|

en-us	### Host prototype  The host prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Prototipus d'equip  L'objecte prototip d'equip té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|*(només lectura)* ID del prototip d'equips.| |**host**<br>(obligatori)|cadena|Nom tècnic del prototip d'equips.| |name|string|Nom visible del prototip d'equips.<br><br>Per defecte: valor de la propietat `host`.| |status|integer|Estat del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* equip supervisat;<br>1 - equip no supervisat.| |inventory\_mode|integer|Mode d'omplerta d'inventari de l'equip.<br><br>Els valors possibles són:<br>-1 - *(per defecte)* desactivat;<br>0 - manual ;<br>1 - automàtic .| |templateid|string|*(només lectura)* ID de la plantilla principal del prototip d'equips.| |discover|integer|Estat de descobriment del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran nous equips;<br>1 - no es descobriran els nous equips i els existents es marcaran com a perduts.| |custom\_interfaces|integer|Font de les interfícies dels equips creats per el prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* hereta les interfícies de l'equip principal; <br>1 - empra personalitzat interfícies de prototips d'equips.| |uuid|string|Identificador universal únic, que s'empra per enllaçar els prototips d'equips importats amb els existents. S'empra només per a prototips d'equips en models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Host prototype  This class is designed to work with host prototypes.  Object references:\  -   [Host     prototype](/manual/api/reference/hostprototype/object#host_prototype) -   [Host prototype     inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Group link](/manual/api/reference/hostprototype/object#group_link) -   [Group     prototype](/manual/api/reference/hostprototype/object#group_prototype)  Available methods:\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) -     creating new host prototypes -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) -     deleting host prototypes -   [hostprototype.get](/manual/api/reference/hostprototype/get) -     retrieving host prototypes -   [hostprototype.update](/manual/api/reference/hostprototype/update) -     updating host prototypes
ca	# Prototipus d'equip  Aquesta classe és dissenyada per treballar amb prototipus d'equips.  Referències d'objectes:\  -   [Prototipus d'equip](/manual/api/reference/hostprototype/object#host_prototype) -   [Inventari de prototipus d'equip](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Enllaç de grup](/manual/api/reference/hostprototype/object#group_link) -   [Prototipus de grup](/manual/api/reference/hostprototype/object#group_prototype)  Mètodes disponibles:\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) - crear nou prototipus d'equip -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) - esborrar prototipus d'equip -   [hostprototype.get](/manual/api/reference/hostprototype/get) -recuperar prototipus d'equip -   [hostprototype.update](/manual/api/reference/hostprototype/update) - actualitzar prototipus d'equip

en-us	# hostprototype.update
ca	# hostprototype.update

en-us	##### Host removal  Hosts discovered by a network discovery rule are removed automatically from *Monitoring* → *Discovery* if a discovered entity is not in the rule's IP range any more. Hosts are removed immediately.
ca	##### Esborrar un equip  Els equips trobats per una regla de descoberta de xarxa s'esborren automàticament de *Monitoratge* → *Descoberta* si una entitat descoberta no es troba pas al rang IP de la regla. Els equips s'esborren de seguida.

en-us	#### Hosts and host groups  Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods.  [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance)
ca	#### Equips i grup d'equips  Gestionar els grups d'equips, els equips i tot el que hi ha relacionat, fins i tot les interfícies i les macros d'equips i els períodes de manteniment.  [API Equip](/manual/api/reference/host) | [API Grup d'equips](/manual/api/reference/hostgroup) | [API Interfície d'equip](/manual/api/reference/hostinterface) | [API Macro d'usuari](/manual/api/reference/usermacro) | [API Mapa de valors](/manual/api/reference/valuemap) | [API Manteniment](/manual/api/reference/maintenance)

en-us	#### Hosts/host prototypes  In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| | |Username|yes| |^|Password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes|
ca	#### Equips/prototips d'equips  A la configuració d'[equip](/manual/config/hosts/host) i de [prototip d'equip](/manual/vm_monitoring#host_prototypes), les macros d'usuari es poden emprar en aquest camps:  |Ubicació|<|Múltiples macros/barreja de text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interfície IP/DNS|<|només DNS| |Port d'Interfície|<|no| |*SNMP v1, v2*|<|<| | |Comunitat SNMP|sí| |*SNMP v3*|<|<| | |Nom del context|sí| |^|Nom de seguretat|sí| |^|Frase secreta d'autenticació|sí| |^|Frase secreta de confidencialitat|sí| |*IPMI*|<|<| | |Nom d'usuari|sí| |^|Paraula de pas|sí| |*Etiquetes*^[2](supported_by_location_user#footnotes)^|<|<| | |Noms d'etiqueta|sí| |^|Valors d'etiqueta|sí|

en-us	##### Host tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |groups| |x| | |Root element for host groups.| | |name|x|`string`| |Host group name.| |hosts| |\-| | |Root element for hosts.| | |host|x|`string`| |Unique host name.| | |name|\-|`string`| |Visible host name.| | |description|\-|`text`| |Host description.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| | |ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| | |ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| | |ipmi\_username|\-|`string`| |Username for IPMI checks.| | |ipmi\_password|\-|`string`| |Password for IPMI checks.| |proxy| |\-| | |Proxy.| | |name|x|`string`| |Name of the proxy (if any) that monitors the host.| |templates| |\-| | |Root element for linked templates.| | |name|x|`string`| |Template name.| |interfaces| |\-| | |Root element for host interfaces.| | |default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| | |type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| | |useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| | |ip|\-|`string`| |IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| | |dns|\-|`string`| |DNS name.<br><br>Required if the connection is made via DNS.| | |port|\-|`string`| |Port number. Supports user macros.| | |interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details| |\-| | |Root element for interface details.| | |version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| | |community|\-|`string`| |SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| | |contextname|\-|`string`| |SNMPv3 context name.<br><br>Used only by SNMPv3 items.| | |securityname|\-|`string`| |SNMPv3 security name.<br><br>Used only by SNMPv3 items.| | |securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| | |authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| | |authpassphrase|\-|`string`| |SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| | |privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| | |privpassphrase|\-|`string`| |SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| | |bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items| |\-| | |Root element for items.| | |*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |tags| |\-| | |Root element for host tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| |macros| |\-| | |Root element for macros.| | |macro|x| | |User macro name.| | |type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| | |value|\-|`string`| |User macro value.| | |description|\-|`string`| |User macro description.| |inventory| |\-| | |Root element for host inventory.| | |<inventory\_property>|\-| | |Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode| |\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps| |\-| | |Root element for host value maps.| | |name|x|`string`| |Value map name.| | |mapping|\-| | |Root element for mappings.| | |value|x|`string`| |Value of a mapping.| | |newvalue|x|`string`| |New value of a mapping.|
ca	##### Etiquetes d'equips  |Element|Propietat de l'element|Obligatori|Tipus|Interval^**[1](#footnote)**^|Descripció| |-------|-----------------|---------|-----|---------- ----------------|------------| |groups|<|x|<|<|Element arrel per a grups d'equips.| |<|name|x|`cadena`|<|Nom del grup d'equips.| |hosts|<|\-|<|<|Element arrel per a equips.| |<|host|x|`string`|<|Nom d'equip distingit. |<|name|\-|`cadena`|<|Nom visible d'equip.| |<|description|\-|`text`|<|Descripció de l'equip.| |<|status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'equip.| |<|ipmi\_authtype|\-|`cadena`|-1 - PER DEFECTE (predeterminat)<br>0 - CAP<br>1 - MD2<br>2 - MD5<br>4 - DRET<br>5 - OEM<br>6 - RMCP\_PLUS|Tipus d'autenticació de sessió IPMI.| |<|ipmi\_privilege|\-|`string`|1 - RECORDATORI<br>2 - USUARI (per defecte)<br>3 - OPERADOR<br>4 - ADMINISTRADOR<br>5 - OEM|Nivell de privilegi de la sessió IPMI .| |<|ipmi\_username|\-|`string`|<|Nom d'usuari per a comprovacions IPMI.| |<|ipmi\_password|\-|`string`|<|Mot de pas per a comprovacions IPMI.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Nom del proxy (si n'hi ha) que monitora l'equip.| |templates|<|\-|<|<|Element arrel per a plantilles enllaçades.| |<|name|x|`cadena`|<|Nom de la plantilla.| |interfaces|<|\-|<|<|Element arrel per a les interfícies d'equip. |<|per defecte|\-|`cadena`|0 - NO<br>1 - SÍ (predeterminat)|Si aquesta és la interfície principal de l'equip.<br>Només pot haver-hi una única interfície principal d'un tipus en un equip.| |<|type|\-|`cadena`|1 - ZABBIX (per defecte)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|tipus d'interfície.| |<|useip|\-|`string`|0 - NO<br>1 - sí (per defecte)|Empreu la IP com a interfície per connectar-vos a l'equip (en cas contrari s'emprarà DNS).| |<|ip|\-|`string`|<|adreça IP, pot ser IPv4 o IPv6.<br><br>Requerit si us connecteu mitjançant una adreça IP.| |<|dns|\-|`string`|<|Nom DNS.<br><br>Requerit si es connecta mitjançant DNS.| |<|port|\-|`cadena`|<|Nombre de port. Admet macros d'usuari.| |<|interfície\_ref|x|`cadena`|Format: `if<N>`|Nom de referència de la interfície a emprar als elements.| |details|<|\-|<|<|Element arrel per als detalls de la interfície.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (per defecte)<br>3 - SNMP\_V3|Emprar aquesta versió de SNMP.| |<|community|\-|`cadena`|<|Comunitat SNMP.<br><br>Requerit pels elements SNMPv1 i SNMPv2.| |<|contextname|\-|`cadena`|<|Nom de context SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|securityname|\-|`string`|<|Nom de seguretat SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (per defecte)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|Nivell de seguretat SNMPv3.<br><br>Només s'empra per a elements SNMPv3. | |<|authprotocol|\-|`string`|0 - MD5 (per defecte)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|Protocol d'autenticació SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|authpassphrase|\-|`cadena`|<|Frase de pas d'autenticació SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|privprotocol|\-|`string`|0 - DES (predeterminat)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 protocol de privadesa.<br><br>Només s'empra per a elements SNMPv3.| |<|privpassphrase|\-|`cadena`|<|Frase de pas de privadesa SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|bulk|\-|`string`|0 - NO<br>1 - SÍ (per defecte)|Empreu consultes massives per a SNMP.| |items|<|\-|<|<|Element arrel dels elements.| |<|*Per als valors de l'etiqueta d'element, veieu [etiquetes d'element d'equip](/manual/xml_export_import/hosts#host_item_tags).*|<|<|<|<| |tags|<|\-|<|<|Element arrel per a les etiquetes d'equip.| |<|tag|x|`cadena`|<|Nom de l'etiqueta.| |<|value|\-|`cadena`|<|Valor de l'etiqueta.| |macros|<|\-|<|<|Element arrel per a macros.| |<|macro|x|<|<|Nom de la macro d'usuari.| |<|type|\-|`cadena`|0 - TEXT (per defecte)<br>1 - SECRET\_TEXT<br>2 - VAULT|Tipus de macro.| |<|value|\-|`cadena`|<|Valor de la macro d'usuari.| |<|description|\-|`cadena`|<|Descripció de la macro de l'usuari.| |inventory|<|\-|<|<|Element arrel per a l'inventari de l'amfitrió.| |<|<inventory\_property>|\-|<|<|Propietat d'inventari individual.<br><br>Totes les propietats d'inventari disponibles es mostren sota les etiquetes respectives, p. <tipus>, <nom>, <SO> (veieu l'exemple anterior).| |mode\_inventory|<|\-|`cadena`|-1 - DESACTIVAT<br>0 - MANUAL (per defecte)<br>1 - AUTOMÀTIC|Mode d'inventari.| |valuemaps|<|\-|<|<|Element arrel per a l'assignació de valors de l'equip.| |<|name|x|`cadena`|<|El nom del valor coincideix.| |<|mapping|\-|<|<|Element arrel per al mapeig.| |<|valor|x|`cadena`|<|Concorda amb el valor.| |<|newvalue|x|`string`|<|Nou valor de coincidència.|

en-us	### Host tag  The host tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.|
ca	### Etiqueta d'equip  L'objecte d'etiqueta d'equip té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta d'equip.| |value|string|Valor de l'etiqueta d'equip.|

en-us	### Host  The host object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Equip  L'objecte equip té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|*(només lectura)* ID de l'equip.| |**host**<br>(obligatori)|string|Nom tècnic de l'equip.| |description|text|Descripció de l'equip.| |flags|integer|*(només lectura)* Origen de l'equip.<br><br>Valors possibles:<br>0 - un equip normal;<br>4 - un equip descobert.| |inventory\_mode|integer|Mode de població d'inventari de l'equip.<br><br>Valors possibles:<br>-1 - *(per defecte)* desactivat;<br>0 - manual;<br>1 - automàtic.| |ipmi\_authtype|integer|Algorisme d'autenticació IPMI.<br><br>Valors possibles:<br>-1 - *(per defecte)* per defecte;<br>0 - cap;<br>1 - MD2; <br> 2 - MD5<br>4 - recte;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|mot de pas IPMI.| |ipmi\_privilege|integer|Nivell de privilegis IPMI.<br><br>Valors possibles:<br>1 - devolució de trucada;<br>2 - *(per defecte)* usuari;<br>3 - operador;<br >4 - admin;<br>5 - OEM.| |ipmi\_username|string|Nom d'usuari IPMI.| |maintenance\_from|timestamp|*(només lectura)* Hora d'inici del manteniment efectiu.| |maintenance\_status|integer|*(només lectura)* Estat efectiu del manteniment.<br><br>Valors possibles:<br>0 - *(per defecte)* sense manteniment;<br>1 - manteniment efectiu. | |maintenance\_type|integer|*(només lectura)* Tipus de manteniment efectiu<br><br>Valors possibles:<br>0 - *(per defecte)* manteniment amb recollida de dades;<br>1 - manteniment sense recollida de dades. | |maintenanceid|string|*(només lectura)* ID del manteniment vigent actualment a l'equip.| |name|string|Nom de l'equip visible.<br><br>Per defecte: valor de la propietat `equip`.| |proxy\_hostid|string|ID de proxy emprat per supervisar l'equip.| |status|integer|Estat i funció de l'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* equip supervisat;<br>1 - equip no supervisat.| |tls\_connect|integer|Connexions a l'equip.<br><br>Valors possibles:<br>1 - *(per defecte)* Sense xifrat;<br>2 - PSK;<br>4 - certificat.| |tls\_accept|integer|Connexions de l'equip.<br><br>Els valors de mapa de bits possibles són:<br>1 - *(per defecte)* Sense xifratge;<br>2 - PSK;<br> 4 - certificat. | |tls\_issuer|string|Emissor del certificat.| |tls\_subject|string|Assumpte del certificat.| |tls\_psk\_identity|string|*(només escriptura)*PSK Identitat. Necessari si `tls_connect` o `tls_accept` tenen PSK habilitat.| |tls\_psk|string|*(només escriptura)*La clau prèviament compartida, com a mínim 32 dígits hexadecimals. Necessari si `tls_connect` o `tls_accept` tenen PSK habilitat.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Host  This class is designed to work with hosts.  Object references:\  -   [Host](/manual/api/reference/host/object#host) -   [Host inventory](/manual/api/reference/host/object#host_inventory)  Available methods:\  -   [host.create](/manual/api/reference/host/create) - creating new     hosts -   [host.delete](/manual/api/reference/host/delete) - deleting hosts -   [host.get](/manual/api/reference/host/get) - retrieving hosts -   [host.massadd](/manual/api/reference/host/massadd) - adding related     objects to hosts -   [host.massremove](/manual/api/reference/host/massremove) - removing     related objects from hosts -   [host.massupdate](/manual/api/reference/host/massupdate) - replacing     or removing related objects from hosts -   [host.update](/manual/api/reference/host/update) - updating hosts
ca	# Equip  Aquesta classe és pensada per treballar amb equips.  Referències d'objectes:\  -   [Equip](/manual/api/reference/host/object#host) -   [Inventari d'equips](/manual/api/reference/host/object#host_inventory)  Mètodes disponibles:\  -   [host.create](/manual/api/reference/host/create) - crear un nou equip -   [host.delete](/manual/api/reference/host/delete) - esborrar equips -   [host.get](/manual/api/reference/host/get) - consultar equips -   [host.massadd](/manual/api/reference/host/massadd) - afegir objectes als equips -   [host.massremove](/manual/api/reference/host/massremove) - esborrar objectes dels equips -   [host.massupdate](/manual/api/reference/host/massupdate) - reemplaçar o esborrar objectes dels equips -   [host.update](/manual/api/reference/host/update) - actualitzar equips

en-us	##### Host trigger tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |triggers| |\-| | |Root element for triggers.| | |expression|x|`string`| |Trigger expression.| | |recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| | |recovery\_expression|\-|`string`| |Trigger recovery expression.| | |correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| | |correlation\_tag|\-|`string`| |The tag name to be used for event correlation.| | |name|x|`string`| |Trigger name.| | |event_name|\-|`string`| |Event name.| | |opdata|\-|`string`| |Operational data.| | |url|\-|`string`| |URL associated with the trigger.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| | |priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| | |description|\-|`text`| |Trigger description.| | |type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| | |manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies| |\-| | |Root element for dependencies.| | |name|x|`string`| |Dependency trigger name.| | |expression|x|`string`| |Dependency trigger expression.| | |recovery\_expression|\-|`string`| |Dependency trigger recovery expression.| |tags| |\-| | |Root element for event tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.|
ca	##### Etiquetes de trigger d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Range^**[1](#footnote)**^|Descripció| |-------|-----------------|---------|-----|---------- ----------------|------------| |triggers|<|\-|<|<|Element arrel dels triggers.| |<|expression|x|`cadena`|<|Expressió de trigger.| |<|recovery\_mode|\-|`string`|0 - EXPRESSIÓ (per defecte)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Base per generar esdeveniments OK| |<|recovery\_expression|\-|`string`|<|Activar l'expressió de recuperació.| |<|correlation\_mode|\-|`string`|0 - DESACTIVAT (predeterminat)<br>1 - TAG\_VALUE|Mode de correlació (sense correlació d'esdeveniments o correlació d'esdeveniments per etiqueta). | |<|correlation\_tag|\-|`string`|<|El nom de l'etiqueta que s'emprarà per a la correlació d'esdeveniments.| |<|nom|x|`cadena`|<|Nom del trigger.| | |event_name|\-|`cadena`| |Nom de l'esdeveniment.| | |opdata|\-|`cadena`| |Informació operacional.| |<|url|\-|`string`|<|URL associat amb el trigger.| |<|estat|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat del trigger.| |<|prioritat|\-|`string`|0 - NO\_CLASSIFICAT (predeterminat)<br>1 - INFO<br>2 - ADVERTIMENT<br>3 - MITJANA<br>4 - ALTA<br>5 - DESASTRE |Gravetat del trigger.| |<|descripció|\-|`text`|<|Descripció del trigger.| |<|tipus|\-|`cadena`|0 - SINGLE (per defecte)<br>1 - MULTIPLE|Tipus de generació d'esdeveniments (un sol esdeveniment problema o diversos esdeveniments problema).| |<|manual\_close|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Tancament manual dels esdeveniments del problema.| |dependències|<|\-|<|<|Element arrel per a dependències.| |<|nom|x|`cadena`|<|Nom de la dependència del trigger.| |<|expressió|x|`cadena`|<|Expressió de dependència del trigger.| |<|recovery\_expression|\-|`string`|<|Activar l'expressió de recuperació de dependència.| |etiquetes|<|\-|<|<|Element arrel per a les etiquetes d'esdeveniments.| |<|etiqueta|x|`cadena`|<|Nom de l'etiqueta.| |<|valor|\-|`cadena`|<|Valor de l'etiqueta.|

en-us	# host.update
ca	# host.update

en-us	##### Host web scenario tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |httptests| |\-| | |Root element for web scenarios.| | |name|x|`string`| |Web scenario name.| | |delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| | |attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| | |agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| | |http\_proxy|\-|`string`| |Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables| |\-| | |Root element for scenario-level variables (macros) that may be used in scenario steps.| | |name|x|`text`| |Variable name.| | |value|x|`text`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`text`| |Header name.| | |value|x|`text`| |Header value.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| | |authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| | |http\_user|\-|`string`| |User name used for basic, HTTP or NTLM authentication.| | |http\_password|\-|`string`| |Password used for basic, HTTP or NTLM authentication.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's certificate is authentic.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.| | |ssl\_cert\_file|\-|`string`| |Name of the SSL certificate file used for client authentication (must be in PEM format).| | |ssl\_key\_file|\-|`string`| |Name of the SSL private key file used for client authentication (must be in PEM format).| | |ssl\_key\_password|\-|`string`| |SSL private key file password.| |steps| |x| | |Root element for web scenario steps.| | |name|x|`string`| |Web scenario step name.| | |url|x|`string`| |URL for monitoring.| |query\_fields| |\-| | |Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| | |name|x|`string`| |Query field name.| | |value|\-|`string`| |Query field value.| |posts| |\-| | |HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| | |name|x|`string`| |Post field name.| | |value|x|`string`| |Post field value.| |variables| |\-| | |Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| | |name|x|`string`| |Variable name.| | |value|x|`string`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| | |timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| | |required|\-|`string`| |Text that must be present in the response. Ignored if empty.| | |status\_codes|\-|`string`| |A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags| |\-| | |Root element for web scenario tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.|
ca	##### Etiquetes d'escenari web d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |httptests| |\-| | |Element arrel per a escenaris web.| | |name|x|`cadena`| |Nom de l'escenari web.| | |delay|\-|`cadena`|Per defecte: 1m|Freqüència d'execució de l'escenari web. Segons, unitat de temps amb sufix o macro d'usuari.| | |attempts|\-|`enter`|1-10 (per defecte: 1)|Nombre d'intents d'execució de passes d'escenari web.| | |agent|\-|`cadena`|Per defecte: Zabbix|Agent client. Zabbix simularà ser el navegador seleccionat. Això és útil quan un lloc web retorna contingut diferent amb diferents navegadors.| | |http\_proxy|\-|`cadena`| |Especifiqueu un proxy HTTP per emprar, en format:`http://[nom d'usuari[:mot de pas]@]proxy.exemple.com[:port]`| |variables| |\-| | |Element arrel per a variables a nivell d'escenari (macros) que es poden emprar a passes d'escenari.| | |name|x|`text`| |Nom de la variable.| | |value|x|`text`| |Valor variable.| |headers| |\-| | |L'element arrel de les capçaleres HTTP que s'enviarà en executar una petició. Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| | |name|x|`text`| |Nom de la capçalera.| | |value|x|`text`| |Valor de la capçalera.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'escenari web.| | |authentication|\-|`cadena`|0 - CAP (per defecte)<br>1 - BÀSICA<br>2 - NTLM|Mètode d'autenticació.| | |http\_user|\-|`cadena`| |Nom d'usuari emprat per a l'autenticació bàsica, HTTP o NTLM.| | |http\_password|\-|`cadena`| |Mot de pas emprat a l'autenticació bàsica, HTTP o NTLM.| | |verify\_peer|\-|`cadena`|0 - NO (predeterminat)<br>1 - SÍ|Validar que el certificat de l'equip és autèntic.| | |verify\_host|\-|`cadena`|0 - NO (per defecte)<br>1 - YES|Valida que el nom de l'equip per a la connexió coincideixi amb el del certificat de l'equip.| | |ssl\_cert\_file|\-|`cadena`| |Nom del fitxer de certificat SSL emprat per a l'autenticació del client (ha de ser en format PEM).| | |ssl\_key\_file|\-|`cadena`| |Nom del fitxer de clau privada SSL emprat per a l'autenticació del client (ha de ser en format PEM).| | |ssl\_key\_password|\-|`cadena`| |Mot de pas del fitxer de clau privada SSL.| |steps| |x| | |Element arrel per a les passes de l'escenari web.| | |name|x|`cadena`| |Nom de la passa de l'escenari web.| | |url|x|`cadena`| |URL de seguiment.| |query\_fields| |\-| | |Element arrel per als camps de consulta: una matriu de camps HTTP que s'afegiran a l'URL quan s'executa una consulta.| | |name|x|`cadena`| |Nom del camp de consulta.| | |value|\-|`cadena`| |Valor del camp de consulta.| |posts| |\-| | |Variables HTTP POST com a cadena (dades de publicació en brut) o com a matriu de camps HTTP (dades de camp de formulari).| | |name|x|`cadena`| |Nom del camp del missatge.| | |value|x|`cadena`| |Valor del camp Post.| |variables| |\-| | |Element arrel de les variables de nivell de passa (macros) que s'haurien d'aplicar després d'aquesta passa.<br><br>Si el valor de la variable té un prefix "regex:", aleshores el seu valor s'agafa de les dades retornades per aquesta passa segons el patró d'expressió regular seguint el prefix 'regex:'| | |name|x|`cadena`| |Nom de la variable.| | |value|x|`cadena`| |Valor variable.| |headers| |\-| | |L'element arrel de les capçaleres HTTP que s'enviarà en executar una petició. Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| | |name|x|`cadena`| |Nom de la capçalera.| | |value|x|`cadena`| |Valor de la capçalera.| | |follow\_redirects|\-|`cadena`|0 - NO<br>1 - SÍ (per defecte)|Seguiu les redireccions HTTP.| | |retrieve\_mode|\-|`cadena`|0 - COS (per defecte)<br>1 - CAPÇALERES<br>2 - AMBDÚES|Mode de recuperació de la resposta HTTP.| | |timeout|\-|`cadena`|Per defecte: 15s|Temps d'execució de la passa. Segons, unitat de temps amb sufix o macro d'usuari.| | |required|\-|`cadena`| |Text que ha de ser present a la resposta. S'ignora si és buit.| | |status\_codes|\-|`cadena`| |Una llista delimitada per comes de codis d'estat HTTP acceptats. S'ignora si és buit. Per exemple: 200-201,210-299| |tags| |\-| | |Element arrel per a les etiquetes de la història web.| | |tag|x|`cadena`| |Nom de l'etiqueta.| | |value|\-|`cadena`| |Valor de l'etiqueta.|

en-us	#### - Housekeeper  The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log).  If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper.  Deleting an item/trigger will also delete problems generated by that item/trigger.  Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records.  For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "0"), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled.  It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field.  ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, data kept in these tables will still be stored in partitions, however, the housekeeper will not drop outdated partitions, and warnings about incorrect configuration will be displayed. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items, and history for deleted items will be cleared when an outdated partition is deleted. :::  [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years.  *Reset defaults* button allows to revert any changes made.
ca	#### - Neteja  La neteja és un procés periòdic, realitzat pel servidor Zabbix. El procés esborra la informació obsoleta i la informació esborrada per l'usuari.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  En aquesta secció, les tasques de manteniment es poden habilitar o desactivar per separat per a cada tasca: Esdeveniments i alertes/Serveis de TI/Sessions d'usuari/Historial/Tendències. La configuració de manteniment de l'auditoria és disponible a una [secció de menú] independent (/manual/web_interface/frontend_sections/administration/general#audit_log).  Si l'esborrat és activat, és possible definir quants dies es conservaran els registres de dades abans d'esborrar-se.  L'esborrat d'un element/trigger també esborrarà els problemes generats per aquest element/trigger.  A més, un esdeveniment només s'esborra mitjançant la neteja si ja no és associat a un problema. Això vol dir que si un esdeveniment és un problema o un esdeveniment de recuperació, no s'esborrarà fins que no s'esborri el registre del problema associat. La neteja esborrarpa els problemes primer i els esdeveniments després, per evitar possibles problemes amb esdeveniments obsolets o registres de problemes.  Per a l'historial i les tendències, hi ha una opció addicional disponible: *Anul·lació del període de l'historial d'articles* i *Anul·lació del període de tendència d'elements*. Aquesta opció us permet establir globalment quants dies es mantindran l'historial/tendències d'articles (d'1 hora a 25 anys; o "0"), en aquest cas, anul·lant els valors establerts per a articles individuals a la [configuració de l'element](/manual/config/items/item) *Període d'emmagatzematge de l'historial/Període d'emmagatzematge de tendències*. Tingueu en compte que el període d'emmagatzematge no es substituirà per als articles que tinguin l'opció de configuració *No conservar l'historial* i/o *No mantindre les tendències* activada.  És possible anul·lar l'historial/període d'emmagatzematge de tendències fins i tot si la neteja interna és desactivada. Per tant, quan s'empra una neteja externa, el període d'emmagatzematge de l'historial es pot establir mitjançant el camp Historial *Període d'emmagatzematge de dades*.  ::: noteimportant Si empreu TimescaleDB, per tal d'aprofitar al màxim la partició automàtica de les taules històriques i de tendències de TimescaleDB, les opcions *Substituïr el període de l'historial d'elements* i *Substituïr el període de tendència d'elements* haurien d'habilitar-se així com l'opció *Activar la neteja interna* per a història i tendències. En cas contrari, les dades conservades en aquestes taules encara s'emmagatzemaran a les particions, però, la neteja no esborrarà pas les particions antigues i es mostraran avisos sobre una configuració incorrecta. Quan s'habilita l'esborrat de particions antigues, el servidor Zabbix i la interfície ja no faran un seguiment dels elements esborrats i l'historial dels elements suprimits s'esborrarà quan s'elimini una partició obsoleta. :::  S'admeten [sufixos de temps](/manual/apèndix/sufixos) als camps de període de temps, per exemple, 1d (un dia), 1w (una setmana). El mínim és 1 dia (1 hora per a la història), el màxim - 25 anys.  El botó *Restableix els valors predeterminats* us permet desfer els canvis fets.

en-us	#### housekeeping  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added support of property `hk_events_service`.\
ca	#### Manteniment  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) afegit el suport de la propietat `hk_events_service`.\

en-us	# housekeeping.get
ca	# housekeeping.get

en-us	# > Housekeeping object  The following objects are directly related to the `housekeeping` API.
ca	# > Objecte de manteniment  Els següents objectes tenen relació directa a l'API `housekeeping`.

en-us	### Housekeeping  The settings object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.|
ca	### Manteniment  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hk\_events\_mode|integer|Activa el manteniment intern per a esdeveniments i alertes.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_events\_trigger|string|Període d'activació d'emmagatzematge de dades. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_events\_service|string|Període d'emmagatzematge de dades del servei. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_internal|string|Període d'emmagatzematge de dades intern. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_discovery|string|Període d'emmagatzematge de dades de descoberta de xarxa. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_autoreg|string|Període d'emmagatzematge de dades del registre automàtic. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_services\_mode|integer|Activa la neteja interna dels serveis.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_services|string|Període d'emmagatzematge de dades del servei. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_audit\_mode|integer|Activa el manteniment intern per a l'auditoria.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_audit|string|Període d'emmagatzematge de dades d'auditoria. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_sessions\_mode|integer|Activa la neteja interna per a les sessions.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_sessions|string|Període d'emmagatzematge de dades de la sessió. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_history\_mode|integer|Activa el manteniment intern de l'historial.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_history\_global|integer|Substitueix el període de l'historial d'elements.<br><br>Valors possibles:<br>0 - No substitueix;<br>1 - *(per defecte)* Substitueix.| |hk\_history|string|Període d'emmagatzematge de dades de l'historial. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 90d.| |hk\_trends\_mode|integer|Activa la neteja interna per a tendències.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_trends\_global|integer|Anul·lació del període de tendència de l'element.<br><br>Valors possibles:<br>0 - No substituir;<br>1 - *(per defecte)* Anul·lar. | |hk\_trends|string|Període de temps per emmagatzemar dades de tendències. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |db\_extension|string|*(només lectura)* Marcador de configuració de l'extensió de la base de dades. Si aquesta marca s'estableix a "timescaledb", el servidor canvia el seu comportament per netejar i suprimir elements.| |compression\_status|integer|Activa la compressió TimescaleDB per a l'historial i les tendències.<br><br>Valors possibles:<br>0 - *(per defecte)* Desactiva;<br>1 - Activa.| |compress\_older|string|Comprimir l'historial i els registres de tendències anteriors al període de temps especificat. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 7d.| |compression\_availability|integer|*(només lectura)* Disponibilitat de compressió.<br><br>Valors possibles:<br>0 - No disponible;<br>1 - Disponible.|

en-us	# Housekeeping  This class is designed to work with housekeeping.  Object references:\  -   [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping)  Available methods:\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) -     retrieve housekeeping -   [housekeeping.update](/manual/api/reference/housekeeping/update) -     update housekeeping
ca	# Manteniment  Aquesta classe és dissenyada per treballar amb el manteniment.  Referències d'objectes:\  -   [Manteniment](/manual/api/reference/housekeeping/object#housekeeping)  Mètodes disponibles:\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) - recuperar el manteniment -   [housekeeping.update](/manual/api/reference/housekeeping/update) - actualitzar el manteniment

en-us	# housekeeping.update
ca	# housekeeping.update

en-us	#### How it works  In log monitoring you may encounter lines similar to these:      Line1: Application 1 stopped     Line2: Application 2 stopped     Line3: Application 1 was restarted     Line4: Application 2 was restarted  The idea of event correlation is to be able to match the problem event from Line1 to the resolution from Line3 and the problem event from Line2 to the resolution from Line4, and close these problems one by one:      Line1: Application 1 stopped     Line3: Application 1 was restarted #problem from Line 1 closed      Line2: Application 2 stopped     Line4: Application 2 was restarted #problem from Line 2 closed  To do this you need to tag these related events as, for example, "Application 1" and "Application 2". That can be done by applying a regular expression to the log line to extract the tag value. Then, when events are created, they are tagged "Application 1" and "Application 2" respectively and problem can be matched to the resolution.
ca	#### Com funciona tot plegat  Al monitoratge del registre, podeu trobar línies semblants a aquestes:       Línia 1: s'ha aturat l'aplicació 1      Línia 2: s'ha aturat l'aplicació 2      Línia 3: s'ha reiniciat l'aplicació 1      Línia 4: s'ha reiniciat l'aplicació 2  La idea de la correlació d'esdeveniments és poder fer coincidir l'esdeveniment problema de Línia 1 amb la resolució de Línia 3 i l'esdeveniment problema Línia 2 amb la resolució de Línia 4, i tancar aquests problemes un per un:       Línia 1: s'ha aturat l'aplicació 1      Línia 3: s'ha reiniciat l'aplicació 1 #problema de la línia 1 tancada       Línia 2: s'ha aturat l'aplicació 2      Línia 4: s'ha reiniciat l'aplicació 2 #problema de la línia 2 tancada  Per fer-ho, heu d'etiquetar aquests esdeveniments associats com, per exemple, "Aplicació 1" i "Aplicació 2". Això es pot fer aplicant una expressió regular a la línia de registre per extreure el valor de l'etiqueta. Aleshores, quan es creen els esdeveniments, s'etiqueten "Aplicació 1" i "Aplicació 2" respectivament i el problema es pot associar amb la resolució.

en-us	#### How to  First you need to create a PHP file and save it as *local/conf/brand.conf.php*. The contents of the file should be as follows:  ```php <?php  return []; ```  This will hide the links to the *Zabbix Support* and *Zabbix Integrations* pages.
ca	#### Com fer-ho  Primer, haureu de crear un arxiu PHP i desar-lo com a *local/conf/brand.conf.php*. El contingut hauria de ser com això:  ```php <?php  return []; ```  Això amagarà els enllaços de les pàgines *Zabbix Support* i *Zabbix Integrations*.

en-us	#### HP OpenView  Zabbix can be configured to send messages to OpenView server. The following steps must be performed:
ca	#### HP OpenView  Es pot configurar Zabbix per enviar els missatges al servidor OpenView. Les següents passes s'haurien de seguir:

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. If this field already contains HTML, it will be rendered as plain text after the upgrade.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
ca	### S'ha deixat el suport HTML a l'atribució de Geomap  El text d'atribució per al [Giny del tauler de geomapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) ara només pot contindre text pla; S'ha tret el suport HTML. Si aquest camp ja conté HTML, es representarà com a text senzill després de l'actualització.  A la configuració de [Mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical-maps) dins la secció Administració → General, el camp *Atribució* ara només és visible quan el *Proveïdor de rajoles* sigui establert a *Altres*.

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
ca	### S'ha deixat el suport HTML a l'atribució de Geomap  El text d'atribució per al [Giny del tauler de geomapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) ara només pot contindre text pla; S'ha tret el suport HTML.   A la configuració de [Mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical-maps) dins la secció Administració → General, el camp *Atribució* ara només és visible quan el *Proveïdor de rajoles* sigui establert a *Altres*.

en-us	### HTTP authentication  HTTP or web server-based authentication (for example: Basic Authentication, NTLM/Kerberos) can be used to check user names and passwords. Note that a user must exist in Zabbix as well, however its Zabbix password will not be used.  ::: noteimportant Be careful! Make sure that web server authentication is configured and works properly before switching it on. :::  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/auth_http.png){width="600"}  Configuration parameters:  |Parameter|Description| |--|--------| |*Enable HTTP authentication*|Mark the checkbox to enable HTTP authentication. Hovering the mouse over ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/auth_http_2.png) will bring up a hint box warning that in the case of web server authentication, all users (even with [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) set to LDAP/Internal) will be authenticated by the web server, not by Zabbix.| |*Default login form*|Specify whether to direct non-authenticated users to:<br>**Zabbix login form** - standard Zabbix login page.<br>**HTTP login form** - HTTP login page.<br>It is recommended to enable web-server based authentication for the `index_http.php` page only. If *Default login form* is set to 'HTTP login page' the user will be logged in automatically if web server authentication module will set valid user login in the `$_SERVER` variable.<br>Supported `$_SERVER` keys are `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Remove domain name*|A comma-delimited list of domain names that should be removed from the username.<br>E.g. `comp,any` - if username is 'Admin\@any', 'comp\\Admin', user will be logged in as 'Admin'; if username is 'notacompany\\Admin', login will be denied.| |*Case sensitive login*|Unmark the checkbox to disable case-sensitive login (enabled by default) for usernames.<br>E.g. disable case-sensitive login and log in with, for example, 'ADMIN' user even if the Zabbix user is 'Admin'.<br>*Note* that with case-sensitive login disabled the login will be denied if multiple users exist in Zabbix database with similar usernames (e.g. Admin, admin).|  ::: notetip For internal users who are unable to log in using HTTP credentials (with HTTP login form set as default) leading to the 401 error, you may want to add a `ErrorDocument 401 /index.php?form=default` line to basic authentication directives, which will redirect to the regular Zabbix login form. :::
ca	### Autenticació HTTP  L'autenticació HTTP o basada en servidor web (per exemple: autenticació bàsica, NTLM/Kerberos) es pot emprar per verificar noms d'usuari i mots de pas. Tingueu en compte que un usuari també ha d'existir a Zabbix, però el seu mot de pas de Zabbix no s'emprarà pas.  ::: noteimportant Compte! Assegureu-vos que l'autenticació del servidor web sigui configurada i funcioni correctament abans d'activar-la. :::  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/auth_http.png){width="600"}  Paràmetres de configuració:  |Paràmetre|Descripció| |--|---------| |*Activa l'autenticació HTTP*|Marqueu la casella per habilitar l'autenticació HTTP. Passant el cursor per damunt de ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/auth_http_2.png) apareixerà un quadre d'avís que advertirà que en el cas del web autenticació del servidor, tots els usuaris (fins i tot per a [accés a la interfície](/manual/config/users_and_usergroups/usergroup#configuration) establert a LDAP/Internal) seran autenticats pel servidor web, no per Zabbix.| |*Formulari d'inici de sessió predeterminat*|Indiqueu si voleu redirigir els usuaris no autenticats a:<br>**Formulari d'inici de sessió Zabbix** - Pàgina d'inici de sessió estàndard de Zabbix.<br>**Formulari d'inici de sessió HTTP** - Pàgina d'inici de sessió HTTP.<br>Es recomana habilitar l'autenticació basada en el servidor web només per a la pàgina `index_http.php`. Si el *Formulari d'inici de sessió predeterminat* s'estableix a 'Pàgina d'inici de sessió HTTP', l'usuari s'iniciarà automàticament si el mòdul d'autenticació del servidor web defineix un inici de sessió d'usuari vàlid a la variable `$_SERVER`.<br>El `$_SERVER` compatible. les claus són `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Esborra el nom de domini*|Una llista delimitada per comes de noms de domini que s'han d'esborrar del nom d'usuari.<br>Ex. `comp,any' - si el nom d'usuari és 'Admin\@any', 'comp\\Admin', l'usuari s'iniciarà com a 'Admin'; si el nom d'usuari és 'notacompany\\Admin', l'inici de sessió serà denegat.| |*Inici de sessió sensible a majúscules i minúscules*|Desmarqueu la casella per desactivar l'inici de sessió sensible a majúscules i minúscules (activat de manera predeterminada) per als noms d'usuari.<br>Ex. desactiveu l'inici de sessió que distingeix entre majúscules i minúscules i, per exemple, l'usuari "ADMINISTRADOR", encara que l'usuari de Zabbix sigui "Administrador".<br>*Tingueu en compte* que amb l'inici de sessió sensible a majúscules i minúscules desactivat, l'inici de sessió es denegarà si existeixen diversos usuaris a la base de dades de Zabbix amb noms d'usuari similars (p. ex. Admin, admin).|  ::: notetip Per als usuaris interns que no poden iniciar sessió amb credencials HTTP (amb el formulari d'inici de sessió HTTP definit com a predeterminat) que genera l'error 401, podeu afegir una línia "ErrorDocument 401 /index.php?form=default" a les directives bàsiques d'autenticació, que redirigeix ​​al formulari d'inici de sessió habitual de Zabbix. :::

en-us	### HTTP field  The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.|
ca	### Camp HTTP  L'objecte de camp HTTP defineix un nom i un valor emprats per especificar una variable, una capçalera HTTP, les dades del camp de formulari POST o les dades de camp de petició. Té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**nom**<br>(obligatori)|string|Nom de la capçalera / variable / camp POST o GET.| |**nom**<br>(obligatori)|string|Valor de la capçalera / variable / camp POST o GET.|

en-us	#### HttpRequest  ::: noteimportant "HttpRequest" is a new name for this object since Zabbix 5.4. Previously it was called "CurlHttpRequest". Method names have also been changed in Zabbix 5.4. The old object/method names are now deprecated and their support will be discontinued after Zabbix 6.0. :::  This object encapsulates cURL handle allowing to make simple HTTP requests. Errors are thrown as exceptions.  ::: noteimportant The initialization of multiple `HttpRequest` objects is limited to 10 per script execution. :::  |Method|Description| |--|--------| |`addHeader(value)`|Adds HTTP header field. This field is used for all following requests until cleared with the `clearHeader()` method.<br>The total length of header fields that can be added to a single `HttpRequest` object is limited to 128 Kbytes (special characters and header names included).| |`clearHeader()`|Clears HTTP header. If no header fields are set, `HttpRequest` will set Content-Type to application/json if the data being posted is JSON-formatted; text/plain otherwise.| |`connect(url)`|Sends HTTP CONNECT request to the URL and returns the response.| |`customRequest(method, url, data)`|Allows to specify any HTTP method in the first parameter. Sends the method request to the URL with optional *data* payload and returns the response.| |`delete(url, data)`|Sends HTTP DELETE request to the URL with optional *data* payload and returns the response.| |`getHeaders(<asArray>)`|Returns the object of received HTTP header fields.<br>The `asArray` parameter may be set to "true" (e.g. `getHeaders(true)`), "false" or be undefined. If set to "true" the received HTTP header field values will be returned as arrays; this should be used to retrieve the field values of multiple same-name headers.<br>If not set or set to "false", the received HTTP header field values will be returned as strings.| |`get(url, data)`|Sends HTTP GET request to the URL with optional *data* payload and returns the response.| |`head(url)`|Sends HTTP HEAD request to the URL and returns the response.| |`options(url)`|Sends HTTP OPTIONS request to the URL and returns the response.| |`patch(url, data)`|Sends HTTP PATCH request to the URL with optional *data* payload and returns the response.| |`put(url, data)`|Sends HTTP PUT request to the URL with optional *data* payload and returns the response.| |`post(url, data)`|Sends HTTP POST request to the URL with optional *data* payload and returns the response.| |`getStatus()`|Returns the status code of the last HTTP request.| |`setProxy(proxy)`|Sets HTTP proxy to "proxy" value. If this parameter is empty then no proxy is used.| |`setHttpAuth(bitmask, username, password)`|Sets enabled HTTP authentication methods (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) in the 'bitmask' parameter.<br>The HTTPAUTH\_NONE flag allows to disable HTTP authentication.<br>Examples:<br>`request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, username, password)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Sends HTTP TRACE request to the URL with optional *data* payload and returns the response.|  Example:  ```javascript try {     Zabbix.log(4, 'jira webhook script value='+value);        var result = {         'tags': {             'endpoint': 'jira'         }     },     params = JSON.parse(value),     req = new HttpRequest(),     fields = {},     resp;        req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic '+params.authentication);        fields.summary = params.summary;     fields.description = params.description;     fields.project = {"key": params.project_key};     fields.issuetype = {"id": params.issue_id};     resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );        if (req.getStatus() != 201) {         throw 'Response code: '+req.getStatus();     }        resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key; } catch (error) {     Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));     Zabbix.log(4, 'jira issue creation failed : '+error);        result = {}; }    return JSON.stringify(result); ```
ca	#### HttpRequest  ::: noteimportant "HttpRequest" és un nom nou per a aquest objecte des de Zabbix 5.4. Abans s'anomenava "CurlHttpRequest". Els noms dels mètodes també es van canviar a Zabbix 5.4. Els noms antics d'objectes/mètodes ara són obsolets i el seu suport es discontinuarà després de Zabbix 6.0. :::  Aquest objecte encapsula el controlador cURL que permet fer peticions HTTP senzilles. Els errors es llancen com a excepcions.  ::: noteimportant La inicialització de diversos objectes `HttpRequest` és limitada a 10 per execució de l'script. :::  |Mètode|Descripció| |--|---------| |`addHeader(name, value)`|Afegiu un camp de capçalera HTTP. Aquest camp s'empra per a totes les peticions posteriors fins que s'esborra amb el mètode clearHeader().<br>L'allargada total dels camps de capçalera que es poden afegir a un únic objecte `HttpRequest` és limitada a 128Ko (inclosos caràcters especials i noms de capçalera).| |`clearHeader()`|Esborra la capçalera HTTP. Si no s'estableix cap camp de capçalera, `HttpRequest` establirà el Content-Type a application/json si les dades publicades són en format JSON; text/llaç en cas contrari.| |`connect(url)`|Envieu la petició HTTP CONNECT a l'URL i retorneu la resposta.| |`customRequest(method, url, data)`|Permet especificar qualsevol mètode HTTP al primer paràmetre. Envieu la petició de mètode a l'URL amb la càrrega útil de *dades* opcional i la resposta de retorn.| |`delete(url, data)`|Envia la petició HTTP DELETE a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`getHeaders(<asArray>)`|Retorna l'objecte dels camps de capçalera HTTP rebuts.<br>El paràmetre `asArray` es pot establir com a "true" (per exemple, `getHeaders(true)`), "false" o ésser indefinit. Si es defineix com a "true", els valors dels camps de capçalera HTTP rebuts es retornaran com a matrius; això s'ha d'emprar per recuperar els valors dels camps de diverses capçaleres amb el mateix nom.<br>Si no s'estableix o s'estableix com a "fals", els valors dels camps de capçalera HTTP rebuts es retornaran com a cadenes. |`get(url, data)`|Envia una petició HTTP GET a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`head(url)`|Envia la petició HTTP HEAD a l'URL i retorna la resposta.| |`options(url)`|Envia la petició HTTP OPTIONS a l'URL i retorna la resposta.| |`patch(url, data)`|Envia la petició HTTP PATCH a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`put(url, data)`|Envia una petició HTTP PUT a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`post(url, data)`|Envia una petició HTTP POST a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`getStatus()`|Retorna el codi d'estat de la darrera petició HTTP.| |`setProxy(proxy)`|Configura el proxy HTTP amb el valor "proxy". Si aquest paràmetre és buit, no s'empra cap proxy.| |`setHttpAuth(bitmask, username, password)`|Defineix els mètodes d'autenticació HTTP activats (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) al paràmetre "bitmask".<br>El HTTPAUTH\_NONE s'empra per desactivar l'autenticació HTTP.<br> Exemples:<br>`request.setHttpAuth(HTTPAUTH_NTLM\| HTTPAUTH_BASIC, nom d'usuari, mot de pas)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Envia la petició de TRACE HTTP a l'URL amb la càrrega útil de *data* opcional i retorna la resposta.|  Exemple:  ```javascript try {     Zabbix.log(4, 'jira webhook script value='+value);        var result = {         'tags': {             'endpoint': 'jira'         }     },     params = JSON.parse(value),     req = new HttpRequest(),     fields = {},     resp;        req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic '+params.authentication);        fields.summary = params.summary;     fields.description = params.description;     fields.project = {"key": params.project_key};     fields.issuetype = {"id": params.issue_id};     resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );        if (req.getStatus() != 201) {         throw 'Response code: '+req.getStatus();     }        resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key; } catch (error) {     Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));     Zabbix.log(4, 'jira issue creation failed : '+error);        result = {}; }    return JSON.stringify(result); ```

en-us	#### httptest  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: the parameter `uuid` can now be updated.\
ca	#### httptest  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: el paràmetre `uuid` ara es pot actualitzar.\

en-us	# httptest.create
ca	# httptest.create

en-us	# httptest.delete
ca	# httptest.delete

en-us	# httptest.get
ca	# httptest.get

en-us	# httptest.update
ca	# httptest.update

en-us	#### Hysteresis  Sometimes an interval is needed between problem and recovery states, rather than a simple threshold. For example, if we want to define a trigger that reports a problem when server room temperature goes above 20°C and we want it to stay in the problem state until the temperature drops below 15°C, a simple trigger threshold at 20°C will not be enough.  Instead, we need to define a trigger expression for the problem event first (temperature above 20°C). Then we need to define an additional recovery condition (temperature below 15°C). This is done by defining an additional *Recovery expression* parameter when [defining](/manual/config/triggers/trigger) a trigger.  In this case, problem recovery will take place in two steps:  -   First, the problem expression (temperature above 20°C) will have to     evaluate to FALSE -   Second, the recovery expression (temperature below 15°C) will have     to evaluate to TRUE  The recovery expression will be evaluated only when the problem event is resolved first.  ::: notewarning The recovery expression being TRUE alone does not resolve a problem if the problem expression is still TRUE! :::
ca	#### Histèresi  De vegades cal un interval entre els estats de problema i de recuperació, en lloc de només un llindar. Per exemple, si volem establir un trigger per informar d'un problema quan la temperatura de la sala del servidor supera els 20 °C i volem que es mantingui en l'estat de problema fins que la temperatura baixi dels 15 °C, un llindar d'activació simple a 20 °C no serà suficient.  el que hem de fer és, primer, definir un trigger per a l'esdeveniment problemàtic (temperatura superior a 20 °C). Tot seguit, hem de definir una condició de recuperació addicional (temperatura inferior a 15 °C). Per fer-ho, definiu un paràmetre addicional *Expressió de recuperació* quan [definiu](/manual/config/triggers/trigger) el trigger.  En aquest cas, la recuperació del problema es farà en dues passes:  - En primer lloc, l'expressió del problema (temperatura superior a 20°C) s'ha de valorar com a FALSE - En segon lloc, l'expressió de recuperació (temperatura inferior a 15 °C) s'ha de valorar com a TRUE  L'expressió de recuperació s'avaluarà només quan es resolgui primer l'esdeveniment problema.  ::: notewarning   L'expressió de recuperació per si sola a TRUE no resol el problema si l'expressió problema encara és TRUE! :::

en-us	#### ICMP pings  Zabbix uses external utility **fping** for processing of ICMP pings.  The utility is not part of Zabbix distribution and has to be additionally installed. If the utility is missing, has wrong permissions or its location does not match the location set in the Zabbix server/proxy configuration file ('FpingLocation' parameter), ICMP pings (**icmpping**, **icmppingloss**, **icmppingsec**) will not be processed.  See also: [known issues](/manual/installation/known_issues#simple_checks)  **fping** must be executable by the user Zabbix daemons run as and setuid root. Run these commands as user **root** in order to set up correct permissions:      chown root:zabbix /usr/sbin/fping     chmod 4710 /usr/sbin/fping  After performing the two commands above check ownership of the **fping** executable. In some cases the ownership can be reset by executing the chmod command.  Also check, if user zabbix belongs to group zabbix by running:      groups zabbix  and if it's not add by issuing:      usermod -a -G zabbix zabbix  Defaults, limits and description of values for ICMP check parameters:  |Parameter|Unit|Description|Fping's flag|Defaults set by|<|Allowed limits<br>by Zabbix|<| |--|--|--------|-|--|--|--|--| |||||**fping**|**Zabbix**|**min**|**max**| |packets|number|number of request packets to a target|-C||3|1|10000| |interval|milliseconds|time to wait between successive packets|-p|1000||20|unlimited| |size|bytes|packet size in bytes<br>56 bytes on x86, 68 bytes on x86_64|-b|56 or 68||24|65507| |timeout|milliseconds|**fping v3.x** - timeout to wait after last packet sent, affected by *-C* flag<br> **fping v4.x** - individual timeout for each packet|-t|**fping v3.x** - 500<br>**fping v4.x** - inherited from *-p* flag, but not more than 2000||50|unlimited|  In addition Zabbix uses fping options *-i interval ms* (do not mix up with the item parameter *interval* mentioned in the table above, which corresponds to fping option *-p*) and *-S source IP address* (or *-I* in older fping versions). Those options are auto-detected by running checks with different option combinations. Zabbix tries to detect the minimal value in milliseconds that fping allows to use with *-i* by trying 3 values: 0, 1 and 10. The value that first succeeds is then used for subsequent ICMP checks. This process is done by each [ICMP pinger](/manual/concepts/server#server_process_types) process individually.  Auto-detected fping options are invalidated every hour and detected again on the next attempt to perform ICMP check. Set DebugLevel>=4 in order to view details of this process in the server or proxy log file.  ::: notewarning Warning: fping defaults can differ depending on platform and version - if in doubt, check fping documentation. :::  Zabbix writes IP addresses to be checked by any of three *icmpping\** keys to a temporary file, which is then passed to **fping**. If items have different key parameters, only ones with identical key parameters are written to a single file.\ All IP addresses written to the single file will be checked by fping in parallel, so Zabbix icmp pinger process will spend fixed amount of time disregarding the number of IP addresses in the file.
ca	#### Pings ICMP  Zabbix empra la utilitat externa **fping** per fer pings ICMP.  La utilitat no forma part de la distribució Zabbix i s'ha d'instal·lar addicionalment. Si manca la utilitat, té permisos incorrectes o la seva ubicació no coincideix amb la ubicació definida al fitxer de configuració del servidor/proxy Zabbix (paràmetre 'FpingLocation'), els pings ICMP (**icmpping**, **icmppingloss**, ** icmppingsec**) no es processaran pas.  Veieu també: [problemes coneguts](/manual/installation/known_issues#simple_checks)  **fping** ha d'ésser executable per l'usuari dels dimonis Zabbix que s'executen com a root i setuid. Executeu aquestes ordres com a usuari **root** per configurar els permisos correctes:      chown root:zabbix /usr/sbin/fping     chmod 4710 /usr/sbin/fping  Després d'executar les dues ordres anteriors, comproveu la propietat de l'executable **fping**. En alguns casos, la propietat es pot restablir executant l'ordre chmod.  Comproveu també si l'usuari zabbix pertany al grup zabbix executant:      groups zabbix  i si no, afegiu-lo executant:      usermod -a -G zabbix zabbix  Després d'executar les dues ordres anteriors, comproveu la propietat de l'executable **fping**. En alguns casos, la propietat es pot restablir executant l'ordre chmod.  Comproveu també si l'usuari zabbix pertany al grup zabbix executant:       grups zabbix Valors per defecte, límits i descripció dels valors dels paràmetres de control ICMP:  |Paràmetre|Unitat|Descripció|Etiqueta Fping|Valors per defecte establerts per|<|Límits permesos<br>per Zabbix|<| |--|--|---------|-|--|--|--|--| |||||**fping**|**Zabbix**|**min**|**max**| |paquets|nombre|nombre de paquets de petició a un objectiu|-C||3|1|10000| |interval|mil·lisegons|temps d'espera entre paquets successius|-p|1000||20|il·limitat| |mida|octets|mida del paquet en octets<br>56 octets a x86, 68 octets a x86_64|-b|56 o 68||24|65507| |timeout|mil·lisegons|**fping v3.x** - temps d'espera després de l'enviament del darrer paquet, afectat per la marca *-C*<br> **fping v4.x** - temps d'espera individual per a cada paquet |-t|* *fping v3.x** - 500<br>**fping v4.x** - heretat de l'assenyalador *-p*, però no més de 2000||50| il·limitat|  A més, Zabbix empra les opcions fping *-i interval ms* (no s'ha de confondre amb el paràmetre d'element *interval* esmentat a la taula anterior, que correspon a l'opció fping *-p*) i *-S adreça IP font* (o * -I* en versions anteriors d'fping). Aquestes opcions es detecten automàticament executant comprovacions amb diferents combinacions d'opcions. Zabbix prova de detectar el valor mínim en mil·lisegons que fping permet emprar amb *-i* provant 3 valors: 0, 1 i 10. El valor que té èxit primer s'empra per a les comprovacions ICMP posteriors. Aquest procés el fa cada procés [ICMP pinger](/manual/concepts/server#server_process_types) individualment.  Les opcions d'fping detectades automàticament s'invaliden cada hora i es tornen a detectar al següent intent de verificació ICMP. Establiu DebugLevel>=4 per mostrar els detalls d'aquest procés al fitxer de registre del servidor o del proxy.  ::: notewarning Exempció de responsabilitat: els valors predeterminats d'fping poden variar segons la plataforma i la versió; en cas de dubte, consulteu la documentació d'fping. :::  Zabbix escriu adreces IP per ésser verificades amb una de les tres claus *icmpping\** a un fitxer temporal, que després es passa a **fping**. Si els elements tenen paràmetres clau diferents, només s'escriuen en un sol fitxer aquells amb paràmetres clau idèntics.\ Totes les adreces IP escrites al fitxer únic es comprovaran mitjançant fping en paral·lel, de manera que el procés Zabbix icmp pinger passarà un temps fix independentment del nombre d'adreces IP del fitxer.

en-us	##### Icon highlighting  If a map element is in problem status, it is highlighted with a round circle. The fill color of the circle corresponds to the severity color of the problem. Only problems on or above the selected severity level will be displayed with the element. If all problems are acknowledged, a thick green border around the circle is displayed.  Additionally:  -   a host in [maintenance](/manual/maintenance) is highlighted with an     orange, filled square. Note that maintenance highlighting has     priority over the problem severity highlighting (since Zabbix 6.0.5,      only if the map element is host). -   a disabled (not-monitored) host is highlighted with a gray, filled     square.  Highlighting is displayed if the *Icon highlighting* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map).
ca	##### Icona ressaltada  Si un element del mapa es troba en un estat problemàtic, es ressalta amb un cercle. El color de farcit del cercle correspon al color de la gravetat del problema. Amb l'element només es mostraran problemes amb el nivell de gravetat seleccionat o superior. Si es resolen tots els problemes, es mostrarà una vora verda gruixuda al voltant del cercle.  A més de:  - un equip a [manteniment](/manual/maintenance) es ressalta amb un quadrat carbassa sòlid. Tingueu en compte que el ressaltat de manteniment té prioritat sobre el ressaltat de la gravetat del problema (des de Zabbix 6.0.5, només si l'element del mapa és un equip). - un equip desactivat (no monitorat) es ressalta amb un quadrat gris ple.  El ressaltat es mostra si la casella de selecció *Icona destacada* és marcada a la [configuració](/manual/config/visualization/maps/map#creating_a_map) del mapa.

en-us	#### iconmap  Changes:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: dropped support of the icon mapping object property `sortorder`.\
ca	#### mapa d'icones  Canvis:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: suport descartat de la propietat de l'objecte de mapatge de la icona `sortorder`.\

en-us	# iconmap.create
ca	# iconmap.create

en-us	# iconmap.delete
ca	# iconmap.delete

en-us	# iconmap.get
ca	# iconmap.get

en-us	# > Icon map object  The following objects are directly related to the `iconmap` API.
ca	# > Objecte mapa d'icones imatge  Els següents objectes tenen relació directa amb l'API `iconmap`.

en-us	### Icon mapping  The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmappingid|string|*(readonly)* ID of the icon map.| |**iconid**<br>(required)|string|ID of the icon used by the icon mapping.| |**expression**<br>(required)|string|Expression to match the inventory field against.| |**inventory\_link**<br>(required)|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.| |iconmapid|string|*(readonly)* ID of the icon map that the icon mapping belongs to.| |sortorder|integer|*(readonly)* Position of the icon mapping in the icon map.|
ca	### Mapatge d'icones  L'objecte defineix una icona específica per emprar-la per als equips amb un valor de camp d'inventari determinat. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconmappingid|string|*(només lectura)* ID de mapatge d'icones.| |**iconid**<br>(obligatori)|string|ID de la icona emprada per l'assignació d'icones.| |**expression**<br>(obligatori)|string|Expressió que coincideixi amb el camp d'inventari.| |**inventory\_link**<br>(obligatori)|integer|ID de camp d'inventari de l'eqio.<br><br>Consulteu [Objecte d'inventari d'equip](/manual/ api/reference/host/object#host_inventory) per a una llista de camps d'inventari compatibles.| |iconmapid|string|*(només lectura)* Id del mapa d'icones al qual pertany el mapatge.| |sortorder|integer|*(només lectura)* Posició de l'assignació d'icones a l'assignació d'icones.|

en-us	#### - Icon mapping  This section allows creating the mapping of certain hosts with certain icons. Host inventory field information is used to create the mapping.  The mappings can then be used in [network map configuration](/manual/config/ visualization/maps/map) to assign appropriate icons to matching hosts automatically.  To create a new icon map, click on *Create icon map* in the top right corner.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_icon_map.png){width="600"}  Configuration parameters:  |Parameter|Description| |--|--------| |*Name*|Unique name of icon map.| |*Mappings*|A list of mappings. The order of mappings determines which one will have priority. You can move mappings up and down the list with drag-and-drop.| |*Inventory field*|Host inventory field that will be looked into to seek a match.| |*Expression*|Regular expression describing the match.| |*Icon*|Icon to use if a match for the expression is found.| |*Default*|Default icon to use.|
ca	#### - Mapatge d'icones  Aquesta secció us permet crear el mapatge de determinats equips amb determinades icones. La informació del camp d'inventari de l'equip s'empra per crear el mapatge.  Els mapes es poden emprar a la [configuració del mapa de xarxa](/manual/config/visualization/maps/map) per assignar automàticament les icones correctes als equips corresponents.  Per crear un mapa d'icones nou, feu clic a *Crear un mapa d'icones* a l'extrem superior dret.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_icon_map.png){width="600"}  Paràmetres de configuració:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic del mapa d'icones.| |*Mapatges*|Una llista de mapes. L'ordre dels mapes determina quins tindran prioritat. Podeu moure mapes amunt i avall per la llista arrossegant i deixant anar.| |*Camp d'inventari*|Camp d'inventari de l'equip que es comprovarà si hi ha una coincidència.| |*Expressió*|Expressió regular que descriu la coincidència.| |*Icona*|Icona a emprar si es troba una coincidència per a l'expressió.| |*Per defecte*|Icona per defecte a emprar.|

en-us	### Icon map  The icon map object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapid|string|*(readonly)* ID of the icon map.| |**default\_iconid**<br>(required)|string|ID of the default icon.| |**name**<br>(required)|string|Name of the icon map.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Mapatge d'icones  L'objecte de mapatge d'icones té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconmapid|string|*(només lectura)* ID del mapa d'icones.| |**default\_iconid**<br>(obligatori)|string|ID de la icona per defecte.| |**name**<br>(obligatori)|string|Nom del mapa d'icones.|  Veieu que per alguns mètodes (actualitzar, esborrar), la combinació de paràmetres obligatoris o opcionals és diferent.

en-us	# Icon map  This class is designed to work with icon maps.  Object references:\  -   [Icon map](/manual/api/reference/iconmap/object#icon_map) -   [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping)  Available methods:\  -   [iconmap.create](/manual/api/reference/iconmap/create) - create new     icon maps -   [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon     maps -   [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon     maps -   [iconmap.update](/manual/api/reference/iconmap/update) - update icon     maps
ca	# Mapa d'icones  Aquesta classe és dissenyada per treballar amb mapes d'icones.  Referències d'objectes:\  -   [Mapa d'icones](/manual/api/reference/iconmap/object#icon_map) -   [Cartografia d'icones](/manual/api/reference/iconmap/object#icon_mapping)  Mètodes disponibles:\  -   [iconmap.create](/manual/api/reference/iconmap/create) - crear nou mapa d'icones -   [iconmap.delete](/manual/api/reference/iconmap/delete) - esborrar mapa d'icones -   [iconmap.get](/manual/api/reference/iconmap/get) - recuperar mapa d'icones -   [iconmap.update](/manual/api/reference/iconmap/update) - actualitzar mapa d'icones

en-us	# iconmap.update
ca	# iconmap.update

en-us	If access rights to persistent storage files are removed during agent operation or other errors occur (e.g. disk full) then errors are logged into the agent log file but the log item does not become NOTSUPPORTED.
ca	Si els drets d'accés als arxius d'emmagatzematge persistent s'esborren durant el funcionament de l'agent o si hi ha altre errors (per exemple, disc dur ple), els errors s'afegiran a l'arxiu de registre de l'agent però l'element de registre serà NO SUPORTAT.

en-us	##### If installed as package  Zabbix agent runs as a daemon process. The agent can be started by executing:      service zabbix-agent start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-agent start  Similarly, for stopping/restarting/viewing status of Zabbix agent, use the following commands:      service zabbix-agent stop     service zabbix-agent restart     service zabbix-agent status
ca	##### Si s'instal·la com a paquet  L’agent Zabbix s'executa com un procés dimoni. L'agent es pot engegar executant:      service zabbix-agent start  Això funcionarà a la majoria de sisetmes GNU/Linux. Sota altres sistemes haureu d'executar aquesta comanda:      /etc/init.d/zabbix-agent start  Igualment, per aturar/reiniciar/veure l'estat de l'agent Zabbix, empreu aquestes comandes:      service zabbix-agent stop     service zabbix-agent restart     service zabbix-agent status

en-us	##### If installed as package  Zabbix proxy runs as a daemon process. The proxy can be started by executing:      service zabbix-proxy start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-proxy start  Similarly, for stopping/restarting/viewing status of Zabbix proxy, use the following commands:      service zabbix-proxy stop     service zabbix-proxy restart     service zabbix-proxy status
ca	##### Si s'instal·la com a paquet  El proxy Zabbix s'executa com a procés dimoni. El proxy es pot engegar executant:      service zabbix-proxy start  Això funcionarà a la majoria dels sistemes GNU/Linux. Sota altres sistemes, haurem d'executar:      /etc/init.d/zabbix-proxy start  De la mateixa manera, per aturar/reiniciar/veure l'estat dell proxy Zabbix, empreu les comandes següents:      service zabbix-proxy stop     service zabbix-proxy restart     service zabbix-proxy status

en-us	##### If installed as package  Zabbix server runs as a daemon process. The server can be started by executing:      service zabbix-server start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-server start  Similarly, for stopping/restarting/viewing status, use the following commands:      service zabbix-server stop     service zabbix-server restart     service zabbix-server status
ca	##### Si s'instal·la com a paquet  El servidor funciona com un procés dimoni. Pot engegar-se executant:      service zabbix-server start  això funcionarà a la majoria dels sistemes GNU/Linux. Sota altre sistemes, haureu de poder executar:      /etc/init.d/zabbix-server start  De la mateixa manera, per aturar/reiniciar/consultar l'estat, empreu les comandes següents:      service zabbix-server stop     service zabbix-server restart     service zabbix-server status

en-us	##### If the webhook test fails  -   *"Media type test failed."* message is displayed, followed by     additional failure details.
ca	##### Si el test de webhook falla  - El missatge *"Ha fallat el test de tipus de suport."* es mostra, seguit de detalls suplementaris de l'error.

en-us	##### If the webhook test is successful  -   *"Media type test successful."* message is displayed -   Server response appears in the gray *Response* field -   Response type (JSON or String) is specified below the *Response*     field
ca	##### Si el test de webhook ha funcionat  - Apareix el missatge *"La prova de tipus de suport ha funcionat."* - La resposta del servidor apareix al camp gris *Resposta* - El tipus de resposta (JSON o String) s'especifica al camp *Resposta*

en-us	# image.create
ca	# image.create

en-us	# image.delete
ca	# image.delete

en-us	# image.get
ca	# image.get

en-us	# > Image object  The following objects are directly related to the `image` API.
ca	# > Objecte imatge  Els següents objectes tenen relació directa amb l'API `image`.

en-us	#### - Images  The Images section displays all the images available in Zabbix. Images are stored in the database.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}  The *Type* dropdown allows you to switch between icon and background images:  -   Icons are used to display [network     map](/manual/config/visualization/maps/map) elements -   Backgrounds are used as background images of network maps  **Adding image**  You can add your own image by clicking on the *Create icon* or *Create background* button in the top right corner.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)  Image attributes:  |Parameter|Description| |--|--------| |*Name*|Unique name of an image.| |*Upload*|Select the file (PNG, JPEG, GIF) from a local system to be uploaded to Zabbix.<br>*Note* that it may be possible to upload other formats that will be converted to PNG during upload. GD library is used for image processing, therefore formats that are supported depend on the library version used (2.0.28 or higher is required by Zabbix).|  ::: noteclassic Maximum size of the upload file is limited by the value of ZBX\_MAX\_IMAGE\_SIZE that is 1024x1024 bytes or 1 MB.\ \ The upload of an image may fail if the image size is close to 1 MB and the `max_allowed_packet` MySQL configuration parameter is at a default of 1MB. In this case, increase the [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet) parameter. :::
ca	#### - Imatges  La secció Imatges mostra totes les imatges disponibles a Zabbix. Les imatges s'emmagatzemen a la base de dades.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}  La llista desplegable *Tipus* us permet canviar entre icones i imatges de fons:  - Les icones s'empren per mostrar elements de [mapes de xarxa](/manual/config/visualization/maps/map) - Els fons s'empren com a imatges de fons de les targetes de xarxa  **Afegir una imatge**  Podeu afegir la vostra pròpia imatge fent clic al botó *Crear una icona* o *Crear fons* a l'extrem superior dret.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)  Atributs de la imatge:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic d'una imatge.| |*Càrrega*|Seleccioneu el fitxer (PNG, JPEG, GIF) d'un sistema local per carregar-lo a Zabbix.<br>*Tingueu en compte* que és possible que es puguin penjar altres formats que es convertiran a PNG en baixar. La biblioteca GD s'empra per al processament d'imatges, de manera que els formats admesos depenen de la versió de la biblioteca emprada (Zabbix requereix 2.0.28 o superior).|  :::noteclassic La mida màxima del fitxer de càrrega és limitada pel valor de ZBX\_MAX\_IMAGE\_SIZE, que és de 1024 x 1024 octets o 1 Mo.\ \ La càrrega d'una imatge pot fallar si la mida de la imatge és propera a 1 Mo i el paràmetre de configuració de MySQL `max_allowed_packet` és d'1Mo per defecte. En aquest cas, augmenteu el paràmetre [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet). :::

en-us	### Image  The image object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageid|string|*(readonly)* ID of the image.| |**name**<br>(required)|string|Name of the image.| |imagetype|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Imatge  L'objecte imatge té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |imageid|string|*(nomes lectura)* ID de l'imatge.| |**name**<br>(obligatori)|string|Nom de l'imatge.| |imagetype|integer|Tipus d'imatge.<br><br>Valors admesos:<br>1 - *(per defecte)* icona;<br>2 - imatge de fons.|  Veieu que per alguns mètodes (actualitzar, esborrar), la combinació de paràmetres obligatoris o opcionals és diferent.

en-us	# Image  This class is designed to work with images.  Object references:\  -   [Image](/manual/api/reference/image/object#image)  Available methods:\  -   [image.create](/manual/api/reference/image/create) - create new     images -   [image.delete](/manual/api/reference/image/delete) - delete images -   [image.get](/manual/api/reference/image/get) - retrieve images -   [image.update](/manual/api/reference/image/update) - update images
ca	# Imatge  Aquesta classe és dissenyada per treballar amb imatges.  Referències d'objectes:\  -   [Imatge](/manual/api/reference/image/object#image)  Mètodes disponibles:\  -   [image.create](/manual/api/reference/image/create) - crear nous imatges -   [image.delete](/manual/api/reference/image/delete) - esborrar imatges -   [image.get](/manual/api/reference/image/get) - recuperar imatges -   [image.update](/manual/api/reference/image/update) - actualitzar imatges

en-us	# image.update
ca	# image.update

en-us	 ### Implementation details  The high availability (HA) cluster is an opt-in solution and it is supported for Zabbix server. The native HA solution is designed to be simple in use, it will work across sites and does not have specific requirements for the databases that Zabbix recognizes. Users are free to use the native Zabbix HA solution, or a third-party HA solution, depending on what best suits the high availability requirements in their environment.  The solution consists of multiple zabbix\_server instances or nodes. Every node:  -   is configured separately -   uses the same database -   may have several modes: active, standby, unavailable, stopped  Only one node can be active (working) at a time. A standby node runs only one  process - the HA manager. A standby node does no data collection,  processing or other regular server activities; they do not listen  on ports; they have minimum database connections.  Both active and standby nodes update their last access time every 5 seconds. Each standby node monitors the last access time of the active node. If the last access time of the active node is over 'failover delay' seconds, the standby node switches itself to be the active node and assigns 'unavailable' status to the previously active node.  The active node monitors its own database connectivity - if it is lost for more than `failover delay-5` seconds, it must stop all processing and switch to standby mode. The active node also monitors the status of the standby nodes - if the last access time of a standby node is over 'failover delay' seconds, the standby node is assigned the 'unavailable' status.  The nodes are designed to be compatible across minor Zabbix versions.
ca	### Detalla de la implementació  El clúster d'alta disponibilitat (HA) és una solució activada i és compatible amb el servidor Zabbix. La solució nadiua HA és dissenyada per ser senzilla d'emprar, funcionarà en tots els llocs i no té requisits específics per a les bases de dades reconegudes per Zabbix. Els usuaris poden emprar la solució nadiua de Zabbix HA o una solució de tercers, la que s'adapti millor als requisits d'alta disponibilitat del seu entorn.  La solució consta de múltiples instàncies o nodes zabbix\_server. Cada node: - es configura per separat - empra la mateixa base de dades - pot tindre diversos modes: actiu, en espera, no disponible, aturat  Només un node pot ésser actiu alhora. Un node d'espera només executa un procés: el gestor d'HA. Un node en espera no fa la recollida de dades, el processament ni altres activitats normals del servidor, ni escolta els ports; té connexions de base de dades mínimes.  Els nodes actius i en espera actualitzen el seu darrer temps d'accés cada 5 segons. Cada node d'espera monitora el darrer moment d'accés del node actiu. Si el darrer moment d'accés del node actiu és superior als segons de "temps d'espera de commutació per error", el node en espera es converteix en el node actiu i assigna l'estat "no disponible" al node anteriorment actiu.  El node actiu controla la seva pròpia connectivitat a la base de dades: si es perd durant més de `delay de failover-5` segons, hauria d'aturar tot el processament i passar al mode d'espera. El node actiu també monitora l'estat dels nodes en espera: si el darrer temps d'accés d'un node en espera supera els segons de "temps d'espera per a errors", al node en espera se li assigna l'estat "no disponible".  Els nodes són dissenyats per ésser compatibles amb versions menors de Zabbix.

en-us	#### Important notes  -   Database monitoring items will become unsupported if no *odbc poller* processes are started in the server or proxy configuration. To activate ODBC pollers, set *StartODBCPollers* parameter in Zabbix [server](/manual/appendix/config/zabbix_server) configuration file or, for checks performed by proxy, in Zabbix [proxy](/manual/appendix/config/zabbix_proxy) configuration file. -   Zabbix does not limit the query execution time. It is up to the user     to choose queries that can be executed in a reasonable amount of     time. -   The [Timeout](/manual/appendix/config/zabbix_server) parameter value     from Zabbix server is used as the ODBC login timeout (note that     depending on ODBC drivers the login timeout setting might be     ignored). -   The SQL command must return a result set like any query with     `select ...`. The query syntax will depend on the RDBMS which will     process them. The syntax of request to a storage procedure must be     started with `call` keyword.
ca	#### Notes importants  - Els elements de monitoratge de la base de dades no seran compatibles si no s'inicia cap procés *odbc poller* a la configuració del servidor o del proxy. Per habilitar els enquestadors ODBC, configureu el paràmetre *StartODBCPollers* al fitxer de configuració del [servidor](/manual/appendix/config/zabbix_server) Zabbix o, per a comprovacions de proxy, al [proxy](/ manual/appendix/config/zabbix_proxy) Zabbix. - Zabbix no limita el temps d'execució de consultes. Correspon a l'usuari triar les consultes que es puguin executar en un temps raonable. - El valor del paràmetre [Timeout](/manual/appendix/config/zabbix_server) del servidor Zabbix s'empra com a temps d'espera de connexió ODBC (tingueu en compte que el paràmetre de temps d'espera de connexió dels controladors ODBC es pot ignorar). - L'ordre SQL ha de retornar un conjunt de resultats com qualsevol consulta amb `select ...`. La sintaxi de les peticions dependrà de l'RDBMS, que les processarà. La sintaxi de consulta d'un procediment d'emmagatzematge s'ha d'iniciar amb la paraula clau `call`.

en-us	#### Important notes  -   If more than one user macro with context exists, Zabbix will try to     match the simple context macros first and then context macros with     regular expressions in an undefined order.  ::: notewarning Do not create different context macros matching the same string to avoid undefined behavior. :::  -   If a macro with its context is not found on host, linked templates     or globally, then the macro without context is searched for. -   Only low-level discovery macros are supported in the context. Any     other macros are ignored and treated as plain text.  Technically, macro context is specified using rules similar to [item key](/manual/config/items/item/key) parameters, except macro context is not parsed as several parameters if there is a `,` character:  -   Macro context must be quoted with `"` if the context contains a `}`     character or starts with a `"` character. Quotes inside quoted     context must be escaped with the `\` character. -   The `\` character itself is not escaped, which means it's impossible     to have a quoted context ending with the `\` character - the macro     {$MACRO:"a:\\b\\c\\"} is invalid. -   The leading spaces in context are ignored, the trailing spaces are     not:     -   For example {$MACRO:A} is the same as {$MACRO: A}, but not         {$MACRO:A }. -   All spaces before leading quotes and after trailing quotes are     ignored, but all spaces inside quotes are not:     -   Macros {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } and {$MACRO:         "A" } are the same, but macros {$MACRO:"A"} and {$MACRO:" A "}         are not.  The following macros are all equivalent, because they have the same context: {$MACRO:A}, {$MACRO: A} and {$MACRO:"A"}. This is in contrast with item keys, where 'key\[a\]', 'key\[ a\]' and 'key\["a"\]' are the same semantically, but different for uniqueness purposes.
ca	#### Notes importants  - Si hi ha diverses macros d'usuari amb context, Zabbix mirarà de fer coincidir macros de context simples primer, després macros de context amb expressions regulars en ordre no definit.  ::: notewarning No creeu macros de context diferents que coincideixin amb la mateixa cadena per evitar un comportament no definit. :::  - Si una macro amb el seu context no es troba a l'equip, en models enllaçats o globalment, es cerca la macro sense context. - Només s'admeten macros de descoberta de baix nivell en context. La resta de macros s'ignoren i es tracten com a text sense format.  Tècnicament, el context de la macro s'especifica mitjançant regles similars als paràmetres [clau d'element](/manual/config/items/item/key), excepte que el context de la macro no s'analitzi com a paràmetres múltiples per haver-hi un caràcter `,`:  - El context de la macro s'ha de citar amb `"` si el context conté un caràcter `}` o comença amb un caràcter `"`. Les cometes dins del context citat s'han d'escapar amb el caràcter `\`. - El caràcter `\` en si no s'escapa, la qual cosa significa que és impossible tindre un context entre cometes que acabi amb el caràcter `\` - la macro {$MACRO:"a:\\ b\\c\\"} és invàlid. - Els espais inicials en el context s'ignoren, els espais finals no són:      - Per exemple {\$MACRO:A} és idèntic a {\$MACRO:A}, però no a {$MACRO:A }. - Tots els espais abans de les cometes inicials i després de les cometes finals s'ignoren, però tots els espais dins de les cometes no ho són:      - Les macros {\$MACRO:"A"}, {\$MACRO: "A"}, {\$MACRO:"A" } i {\$MACRO: "A" } són idèntiques, però les macros {\ $MACRO:"A"} i {\$MACRO:"A"} no ho són.  Les macros següents són equivalents perquè tenen el mateix context: {\$MACRO:A}, {\$MACRO:A} i {\$MACRO:"A"}. Això contrasta amb les claus d'element, on "clau\[a\]", "clau\[a\]" i "clau\["a"\]" són semànticament iguals, però diferents per a finalitats d'unicitat.