en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|[Template groups](/manual/api/reference/templategroup/object#template_group) to propagate.<br><br>The template groups must have only the `groupid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |permissions|boolean|Set `true` if need to propagate permissions.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|  
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|[Grups de plantilles](/manual/api/reference/templategroup/object#template_group) on propagar.<br>Tots els altres grups excepte els esmentats seran exclosos dels grups d'equips.<br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |permissions|boolean|Establir-ho a `true` per propagar permisos.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeids|ID/array|Return only nodes with the given node IDs.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `name`, `lastaccess`, `status`.| |countOutput|flag|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |ha\_nodeids|ID/array|Retorna només nodes amb identificadors de nodes donats.| |filter|object|Retorna només resultats que coincideixen exactament amb el filtre donat.<br><br>Admet un objecte, on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar. <br><br>Admet les propietats: `name`, `address`, `status`.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Valors possibles: `name`, `lastaccess`, `status`.| |countOutput|flag|Com que aquests paràmetres són comuns a tots els mètodes `get`, es descriuen detalladament a [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |sortorder|string/array|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |history|integer|History object types to return.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - *(default)* numeric unsigned;<br>4 - text;<br>5 - binary.| |hostids|ID/array|Return only history from the given hosts.| |itemids|ID/array|Return only history from the given items.| |time\_from|timestamp|Return only values that have been received after or at the given time.| |time\_till|timestamp|Return only values that have been received before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `itemid`, `clock`, `ns`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |history|integer|Tipus d'objectes d'historial a retornar.<br><br>Valors possibles:<br>0 - flotant numèric;<br>1 - caràcter;<br>2 - registre;<br>3 - *(per defecte)* numèric sense signe;<br>4 - text;<br>5 - binari.| |hostids|ID/array|Retorna només l'historial dels equips donats.| |itemids|ID/array|Retorna només l'historial dels elements donats.| |time\_from|timestamp|Retorna només els valors que s'han rebut després o en el moment donat.| |time\_till|timestamp|Retorna només els valors que s'han rebut abans o en el moment donat.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `itemid`, `clock`, `ns`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen a la pàgina [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostids|ID/array|Return only host interfaces used by the given hosts.| |interfaceids|ID/array|Return only host interfaces with the given IDs.| |itemids|ID/array|Return only host interfaces used by the given items.| |triggerids|ID/array|Return only host interfaces used by items in the given triggers.| |selectItems|query|Return an [`items`](/manual/api/reference/host/object) property with the items that use the interface.<br><br>Supports `count`.| |selectHosts|query|Return a [`hosts`](/manual/api/reference/host/object) property with an array of hosts that use the interface.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectItems`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `interfaceid`, `dns`, `ip`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida desitjada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostids|ID/array|Retorna només les interfícies d'equip emprades pels equips donats.| |interfaceids|ID/array|Retorna només les interfícies d'equip amb els IDs donats.| |itemids|ID/array|Retorna només les interfícies d'equip emprades pels elements donats.| |triggerids|ID/array|Retorna només les interfícies d'equip emprades pels triggers donats.| |selectItems|query|Retorna una propietat [`items`](/manual/api/reference/host/object) que conté els elements que empren la interfície.<br><br>Admet `count`.| |selectHosts|query|Retorna una propietat [`hosts`](/manual/api/reference/host/object) que conté una matriu dels equips que empren la interfície.| |limitSelects|integer|Limita el nombre de registres retornats per subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selectItems`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `interfaceid`, `dns`, `ip`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostids|ID/array|Return only host prototypes with the given IDs.| |discoveryids|ID/array|Return only host prototypes that belong to the given LLD rules.| |inherited|boolean|If set to `true` return only items inherited from a template.| |selectDiscoveryRule|query|Return a [`discoveryRule`](/manual/api/reference/discoveryrule/object#lld_rule) property with the LLD rule that the host prototype belongs to.| |selectInterfaces|query|Return an [`interfaces`](/manual/api/reference/hostprototype/object#custom_interface) property with host prototype custom interfaces.| |selectGroupLinks|query|Return a [`groupLinks`](/manual/api/reference/hostprototype/object#group_link) property with the group links of the host prototype.| |selectGroupPrototypes|query|Return a [`groupPrototypes`](/manual/api/reference/hostprototype/object#group_prototype) property with the group prototypes of the host prototype.| |selectMacros|query|Return a [`macros`](/manual/api/reference/usermacro/object) property with host prototype macros.| |selectParentHost|query|Return a [`parentHost`](/manual/api/reference/host/object) property with the host that the host prototype belongs to.| |selectTags|query|Return a [`tags`](/manual/api/reference/hostprototype/object#host_prototype_tag) property with host prototype tags.| |selectTemplates|query|Return a [`templates`](/manual/api/reference/template/object) property with the templates linked to the host prototype.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostids|ID/array|Retorna només els prototips d'equips amb els identificadors donats.| |discoveryids|ID/array|Retorna només els prototips d'equips que pertanyen a les regles de descobriment de baix nivell donades.| |inherited|boolean|Si s'estableix a `true`, només retorna els elements heretats d'un model.| |selectDiscoveryRule|query|Retorna una propietat [`discoveryRule`](/manual/api/reference/discoveryrule/object#lld_rule) que conté la regla de descoberta de baix nivell a la qual pertany el prototip d'equips.| |selectInterfaces|query|Retorna una propietat [`interfaces`](/manual/api/reference/hostprototype/object#custom_interface) que conté les interfícies personalitzades del prototip d'equips.| |selectGroupLinks|query|Retorna una propietat [`grouplinks`](/manual/api/reference/hostprototype/object#group_link) que conté els enllaços de grup del prototip d'equips.| |selectGroupPrototypes|query|Retorna una propietat [`groupPrototypes`](/manual/api/reference/hostprototype/object#group_prototype) que conté els prototips de grup del prototip d'equips.| |selectMacros|query|Retorna una propietat [`macros`](/manual/api/reference/usermacro/object) que conté les macros del prototip d'equips.| |selectParentHost|query|Retorna una propietat [`parentHost`](/manual/api/reference/host/object) que conté l'equip al qual pertany el prototip d'equips.| |selectTags|query|Retorna una propietat [`tags`](/manual/api/reference/hostprototype/object#host_prototype_tag) que conté les etiquetes del prototip d'equips.| |selectTemplates|query|Retorna una propietat [`templates`](/manual/api/reference/template/object) que conté plantilles relacionades amb el prototip d'equips.<br><br>Admet `count`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `hostid`, `host`, `name` i `status`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapids|ID/array|Return only icon maps with the given IDs.| |sysmapids|ID/array|Return only icon maps that are used in the given maps.| |selectMappings|query|Return a [`mappings`](/manual/api/reference/iconmap/object#icon_mapping) property with the icon mappings used.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `iconmapid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconmapids|ID/array|Retorna només mapes d'icones amb els identificadors donats.| |sysmapids|ID/array|Retorna els mapes d'icones emprats als mapes d'icones donats.| |selectMappings|query|Retorna una propietat [`mappings`](/manual/api/reference/iconmap/object#icon_mapping) amb els mapatges d'icones emprats.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `iconmap` i `name`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageids|ID/array|Return only images with the given IDs.| |sysmapids|ID/array|Return images that are used on the given maps.| |select\_image|flag|Return an `image` property with the Base64 encoded image.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `imageid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |imageids|ID/array|Retorna només imatges amb els identificadors donats.| |sysmapids|ID/array|Retorna les imatges emprades en els mapes d'icones donats.| |select\_image|flag|Retorna una propietat `imatge` que conté la imatge codificada en Base64.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `imageid` i `name`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemids|ID/array|Return only items with the given IDs.| |groupids|ID/array|Return only items that belong to the hosts from the given groups.| |templateids|ID/array|Return only items that belong to the given templates.| |hostids|ID/array|Return only items that belong to the given hosts.| |proxyids|ID/array|Return only items that are monitored by the given proxies.| |interfaceids|ID/array|Return only items that use the given host interfaces.| |graphids|ID/array|Return only items that are used in the given graphs.| |triggerids|ID/array|Return only items that are used in the given triggers.| |webitems|flag|Include web items in the result.| |inherited|boolean|If set to `true` return only items inherited from a template.| |templated|boolean|If set to `true` return only items that belong to templates.| |monitored|boolean|If set to `true` return only enabled items that belong to monitored hosts.| |group|string|Return only items that belong to a group with the given name.| |host|string|Return only items that belong to a host with the given name.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array|Return only items with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all items.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal;<br>4 - Exists;<br>5 - Not exists.| |with\_triggers|boolean|If set to `true` return only items that are used in triggers.| |selectHosts|query|Return a [`hosts`](/manual/api/reference/host/object) property with an array of hosts that the item belongs to.| |selectInterfaces|query|Return an [`interfaces`](/manual/api/reference/hostinterface/object) property with an array of host interfaces used by the item.| |selectTriggers|query|Return a [`triggers`](/manual/api/reference/trigger/object) property with the triggers that the item is used in.<br><br>Supports `count`.| |selectGraphs|query|Return a [`graphs`](/manual/api/reference/graph/object) property with the graphs that contain the item.<br><br>Supports `count`.| |selectDiscoveryRule|query|Return a [`discoveryRule`](/manual/api/reference/discoveryrule/object) property with the LLD rule that created the item.| |selectItemDiscovery|query|Return an `itemDiscovery` property with the item discovery object. The item discovery object links the item to an item prototype from which it was created.<br><br>It has the following properties:<br>`itemdiscoveryid` - `(string)` ID of the item discovery;<br>`itemid` - `(string)` ID of the discovered item;<br>`parent_itemid` - `(string)` ID of the item prototype from which the item has been created;<br>`key_` - `(string)` key of the item prototype;<br>`lastcheck` - `(timestamp)` time when the item was last discovered;<br>`status` - `(int)` item discovery status:<br>0 - *(default)* item is discovered,<br>1 - item is not discovered anymore;<br>`ts_delete` - `(timestamp)` time when an item that is no longer discovered will be deleted;<br>`ts_disable` - `(timestamp)` time when an item that is no longer discovered will be disabled;<br>`disable_source` - `(int)` indicator of whether item was disabled by an LLD rule or manually:<br>0 - *(default)* disabled automatically,<br>1 - disabled by an LLD rule.| |selectPreprocessing|query|Return a [`preprocessing`](/manual/api/reference/item/object#item_preprocessing) property with item preprocessing options.| |selectTags|query|Return the item tags in [`tags`](/manual/api/reference/item/object#Item_tag) property.| |selectValueMap|query|Return a [`valuemap`](/manual/api/reference/valuemap/object) property with item value map.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Does not support properties of `text` [data type](/manual/api/reference_commentary#data-types).<br><br>Supports additional properties:<br>`host` - technical name of the host that the item belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectGraphs` - results will be sorted by `name`;<br>`selectTriggers` - results will be sorted by `description`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `itemid`, `name`, `key_`, `delay`, `history`, `trends`, `type`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemids|ID/array|Retorna només els elements amb els identificadors donats.| |groupids|ID/array|Retorna només els elements que pertanyen als equips dels grups donats.| |templateids|ID/array|Retorna només els elements que pertanyen a les plantilles donades.| |hostids|ID/array|Retorna només els elements que pertanyen als equips donats.| |proxyids|ID/array|Retorna només els elements monitorats pels proxys donats.| |interfaceids|ID/array|Retorna només elements que empren les interfícies d'equip donades.| |graphids|ID/array|Retorna només els elements emprats en els gràfics donats.| |triggerids|ID/array|Retorna només els elements emprats en els triggers donats.| |webitems|flag|Inclou elements web al resultat.| |inherited|boolean|Si s'estableix a `true`, només retorna els elements heretats d'un model.| |templated|boolean|Si s'estableix a `true`, retorna només els elements que pertanyen a les plantilles.| |monitored|boolean|Si s'estableix a `true`, només retorna els elements activats que pertanyen als equips monitorats.| |group|string|Retorna només els elements que pertanyen a un grup amb el nom especificat.| |host|string|Retorna només els elements que pertanyen a un equip amb el nom especificat.| |evaltype|integer|Regles de cerca d'etiquetes.<br><br>Valors possibles:<br>0 - (per defecte) I/O;<br>2 - O.| |tags|array of objects|Retorna només els elements amb les etiquetes donades. Concordança exacta per lectura de btag i cerca que distingeix entre majúscules i minúscules o no distingeix entre majúscules i minúscules pel valor de l'etiqueta en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "valor": " <valor>", " operador": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els elements.<br><br>Tipus d'operadors possibles:<br>0 - (per defecte) És com;<br> 1 - Igual;<br>2 - No és com;<br>3 - No és igual<br>4 - Existeix;<br>5 - No existeix.| |with\_triggers|boolean|Si s'estableix a `true`, només retorna els elements emprats als triggers.| |selectHosts|query|Retorna una propietat [`hosts`](/manual/api/reference/host/object) que conté una matriu d'equips a què pertany l'element.| |selectInterfaces|query|Retorna una propietat [`interfaces`](/manual/api/reference/hostinterface/object) que conté una matriu d'interfícies d'equip emprades per l'element.| |selectTriggers|query|Retorna una propietat [`triggers`](/manual/api/reference/trigger/object) que conté els triggers que empra aquest element.<br><br>Admet `count`.| |selectGraphs|query|Retorna una propietat [`graphs`](/manual/api/reference/graph/object) que conté els gràfics que empra l'element.<br><br>Admet `count`.| |selectDiscoveryRule|query|Retorna una propietat [`discoveryRule`](/manual/api/reference/discoveryrule/object) que conté la regla de descoberta de baix nivell que va crear l'element.| |selectItemDiscovery|query|Retorna l'objecte de descoberta d'elements a la propietat `itemDiscovery`. L'objecte de descoberta d'elements enllaça l'element a un prototip d'element des del qual s'ha creat.<br><br>Té les propietats següents:<br>`itemdiscoveryid` - `(string)` Identificador de descoberta de l'element;<br>`itemid ` - `(string)` Identificació de l'element descobert ;<br>`parent_itemid` - `(string)` Identificador del prototip d'element des del qual s'ha creat l'element;<br>`key_` - `(cadena)` clau del prototip de l'element;< br>`lastcheck` - `(timestamp)` quan l'element es va descobrir per última vegada;<br>`status` - `(int)` estat de la descoberta de l'element:<br>0 - *(per defecte)* s'ha trobat l'element,<br>1 - l'element ja no es troba;<br>`ts_delete` - `(timestamp)` quan s'esborrarà un element que ja no es troba;<br>`ts_disable` - `(timestamp)` quan es deshabilitarà un element que ja no es troba;<br>`disable_source` - `(int)` indicador sobre si l'element s'ha deshabilitat per una regla LLD o manualment:<br>0 - *(per defecte)* es desactiva automàticament,<br>1 - es desactiva per una regla LLD.| |selectPreprocessing|query|Retorna una propietat [`preprocessing`](/manual/api/reference/item/object#item_preprocessing) que conté opcions de preprocessament d'elements.| |selectTags|query|Retorna etiquetes d'element a la propietat [`tags`](/manual/api/reference/item/object#Item_tag).| |selectValueMap|query|Retorna una propietat [`valuemap`](/manual/api/reference/valuemap/object) que conté el mapa de valors de l'element.| |filter|object|Només retorna resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta una matriu on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar.< br><br>Admet filtres addicionals:<br>`host` - Nom tècnic de l'equip al qual pertany l'element.| |limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selectGraphs` - els resultats s'ordenaran per `name`;< br>`selectTriggers` - resultats s'ordenarà per `description`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `itemid`, `name`, `key_`, `delay`, `history`, `trends` , `type` i `status`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemids|ID/array|Return only LLD rules with the given IDs.| |groupids|ID/array|Return only LLD rules that belong to the hosts from the given groups.| |hostids|ID/array|Return only LLD rules that belong to the given hosts.| |inherited|boolean|If set to `true` return only LLD rules inherited from a template.| |interfaceids|ID/array|Return only LLD rules use the given host interfaces.| |monitored|boolean|If set to `true` return only enabled LLD rules that belong to monitored hosts.| |templated|boolean|If set to `true` return only LLD rules that belong to templates.| |templateids|ID/array|Return only LLD rules that belong to the given templates.| |selectFilter|query|Return a [`filter`](/manual/api/reference/discoveryrule/object#LLD_rule_filter) property with data of the filter used by the LLD rule.| |selectGraphs|query|Returns a [`graphs`](/manual/api/reference/graph/object) property with graph prototypes that belong to the LLD rule.<br><br>Supports `count`.| |selectHostPrototypes|query|Return a [`hostPrototypes`](/manual/api/reference/hostprototype/object) property with host prototypes that belong to the LLD rule.<br><br>Supports `count`.| |selectHosts|query|Return a [`hosts`](/manual/api/reference/host/object) property with an array of hosts that the LLD rule belongs to.| |selectItems|query|Return an [`items`](/manual/api/reference/item/object) property with item prototypes that belong to the LLD rule.<br><br>Supports `count`.| |selectTriggers|query|Return a [`triggers`](/manual/api/reference/trigger/object) property with trigger prototypes that belong to the LLD rule.<br><br>Supports `count`.| |selectLLDMacroPaths|query|Return an [`lld_macro_paths`](/manual/api/reference/discoveryrule/object#lld_macro_path) property with a list of LLD macros and paths to values assigned to each corresponding macro.| |selectPreprocessing|query|Return a [`preprocessing`](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) property with LLD rule preprocessing options.| |selectOverrides|query|Return an [`lld_rule_overrides`](/manual/api/reference/discoveryrule/object#lld_rule_overrides) property with a list of override filters, conditions and operations that are performed on prototype objects.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Does not support properties of `text` [data type](/manual/api/reference_commentary#data-types).<br><br>Supports additional properties:<br>`host` - technical name of the host that the LLD rule belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects: `selectItems`, `selectGraphs`, `selectTriggers`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `itemid`, `name`, `key_`, `delay`, `type`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(objecte)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemids|ID/array|Retorna només les regles amb els ID donats.| |groupids|ID/array|Retorna només les regles que pertanyen als grups d'equips donats.| |hostids|ID/array|Retorna només les regles que pertanyen als equips donats.| |inherited|boolean|Si s'estableix a `true`, només retorna les regles heretades d'un model.| |interfaceids|ID/array|Retorna només regles emprant les interfícies d'equip donades.| |monitored|boolean|Si s'estableix a `true`, només es retornaran les regles actives que pertanyen als equips supervisats.| |templated|boolean|Si es defineix com a `true`, només es retornaran les regles que pertanyen a les plantilles.| |templateids|ID/array|Retorna només les regles que pertanyen a les plantilles donades.| |selectFilter|query|Retorna el filtre emprat per la regla a la propietat [filtre](/manual/api/reference/discoveryrule/object#LLD_rule_filter).| |selectGraphs|query|Retorna els prototips de gràfics que pertanyen a la regla a la propietat [gràfics](/manual/api/reference/graph/object).<br><br>Admet `count`.| |selectHostPrototypes|query|Retorna els prototips d'equip que pertanyen a la regla a la propietat [hostPrototypes](/manual/api/reference/hostprototype/object).<br><br>Admet `count`.| |selectHosts|query|Retorna l'equip al que pertany la regla com a matriu a la propietat [equips](/manual/api/reference/host/object).| |selectItems|query|Retorna els prototips d'elements que pertanyen a la regla a la propietat [elements](/manual/api/reference/item/object).<br><br>Admet `count`.| |selectTriggers|query|Retorna els prototips de trigger que pertanyen a la regla a la propietat [triggers](/manual/api/reference/trigger/object).<br><br>Admet `count`.| |selectLLDMacroPaths|query|Retorna una propietat [lld\_macro\_paths](/manual/api/reference/discoveryrule/object#lld_macro_path) amb una llista de macros LLD i camins als valors assignats a cada macro corresponent.| |selectPreprocessing|query|Retorna una propietat de [preprocessament](/manual/api/reference/discoveryrule/object#lld-rule-preprocessing) amb les opcions de preprocessament de la regla LLD.| |selectOverrides|query|Retorna una propietat [lld\_rule\_overrides](/manual/api/reference/discoveryrule/object#lld_rule_overrides) amb una llista de filtres d'anul·lació, condicions i operacions realitzades en objectes prototip.| |filtre|object|Només retorna resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta una matriu on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar.< br><br>Admet filtres addicionals:<br>`host` - nom tècnic de l'equip al qual pertany la regla.| |limitSelects|integer|Limita el nombre de registres retornats per subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selctItems`;<br>`selectGraphs`;<br> `selectTriggers`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `itemid`, `name`, `key_`, `delay`, `type` i `status`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemids|ID/array|Return only trends with the given item IDs.| |time\_from|timestamp|Return only values that have been collected after or at the given time.| |time\_till|timestamp|Return only values that have been collected before or at the given time.| |countOutput|boolean|Count the number of retrieved objects.| |limit|integer|Limit the amount of retrieved objects.| |output|query|Set fields to output.|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemids|ID/array|Retorna només tendències amb els ID d'elements donats.| |time\_from|timestamp|Retorna només els valors recollits després o a l'hora especificada.| |time\_till|timestamp|Retorna només els valors recollits abans o a l'hora especificada.| |countOutput|boolean|Compta el nombre d'objectes recuperats.| |limit|integer|Limita la quantitat d'objectes obtinguts.| |output|query|Defineix els camps a mostrar.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediaids|ID/array|Return only users that use the given media.| |mediatypeids|ID/array|Return only users that use the given media types.| |userids|ID/array|Return only users with the given IDs.| |usrgrpids|ID/array|Return only users that belong to the given user groups.| |getAccess|flag|Adds additional information about user permissions.<br><br>Adds the following properties for each user:<br>`gui_access` - `(integer)` user's frontend authentication method. Refer to the `gui_access` property of the [user group object](/manual/api/reference/usergroup/object#user_group) for a list of possible values.<br>`debug_mode` - `(integer)` indicates whether debug is enabled for the user. Possible values: 0 - debug disabled, 1 - debug enabled.<br>`users_status` - `(integer)` indicates whether the user is disabled. Possible values: 0 - user enabled, 1 - user disabled.| |selectMedias|query|Return media used by the user in the [`medias`](/manual/api/reference/user/object#media) property.| |selectMediatypes|query|Return media types used by the user in the [`mediatypes`](/manual/api/reference/mediatype/object) property.| |selectUsrgrps|query|Return user groups that the user belongs to in the [`usrgrps`](/manual/api/reference/usergroup/object) property.| |selectRole|query|Return user role in the [`role`](/manual/api/reference/role/object#role) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `userid`, `username`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |mediaids|ID/array|Retorna només els usuaris que són emprant el suport donat.| |mediatypeids|ID/array|Retorna només els usuaris que empren els tipus de suport donats.| |userids|ID/array|Retorna només els usuaris amb els identificadors donats.| |usrgrpids|ID/array|Retorna només els usuaris que pertanyen als grups d'usuaris donats.| |getAccess|flag|Afegeix informació addicional sobre els permisos d'usuari.<br><br>Afegeix les propietats següents per a cada usuari:<br>`gui_access` - `(integer)` mètode d'autenticació frontal de l'usuari. Consulteu la propietat `gui_access` de l'[objecte de grup d'usuaris](/manual/api/reference/usergroup/object#user_group) per pbtomdre una llista de possibles valors.<br>`debug_mode` - `( integer)` indica si el mode de depuració és habilitat per a l'usuari. Valors possibles: 0 - depuració desactivada, 1 - depuració activada.<br>`users_status` - `(integer)` indica si l'usuari és desactivat. Valors possibles: 0 - usuari actiu, 1 - usuari desactivat.| |selectMedias|query|Retorna el suport emprat per l'usuari a la propietat [suports](/manual/api/reference/user/object#media).| |selectMediatypes|query|Retorna els tipus de suport emprats per l'usuari a la propietat [mediatypes](/manual/api/reference/mediatype/object).| |selectUsrgrps|query|Retorna els grups d'usuaris als quals pertany l'usuari a la propietat [usrgrps](/manual/api/reference/usergroup/object).| |selectRole|query|Retorna el rol d'usuari a la propietat [rol](/manual/api/reference/role/object#role).| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `userid` i `username`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediatypeids|ID/array|Return only media types with the given IDs.| |mediaids|ID/array|Return only media types used by the given media.| |userids|ID/array|Return only media types used by the given users.| |selectActions|query|Return an [`actions`](/manual/api/reference/action/object) property with the actions that use the media type.| |selectMessageTemplates|query|Return a [`message_templates`](/manual/api/reference/mediatype/object#Message_template) property with an array of media type messages.| |selectUsers|query|Return a [`users`](/manual/api/reference/user/object) property with the users that use the media type.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `mediatypeid`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |mediatypeids|ID/array|Retorna només els tipus de suport amb els identificadors donats.| |mediaids|ID/array|Retorna només els tipus de suport emprats pel suport donat.| |userids|ID/array|Retorna només els tipus de suport emprats pels usuaris donats.| |selectActions|query|Retorna una propietat [`actions`](/manual/api/reference/action/object) property amb les accions que empren el tipus de suport.| |selectMessageTemplates|query|Retorna una propietat [`message\_templates`](/manual/api/reference/mediatype/object#Message_template) amb una matriu de missatges de tipus multimèdia.| |selectUsers|query|Retorna una propietat [`users`](//manual/api/reference/user/object) amb els usuaris que empren el tipus de suport.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `mediatypeid`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mfaids|ID/array|Return only MFA methods with the given IDs.| |selectUsrgrps|query|Return a `usrgrps` property with [user groups](/manual/api/reference/usergroup/object) associated with MFA methods.<br><br>Supports `count`.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Supports properties:<br>`mfaid` - ID of the MFA method;<br>`type` - Type of the MFA method.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `name`.| |search|object|Return results that match the given pattern (case-insensitive).<br><br>Possible values: `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |mfaids|ID/array|Retorna només els mètodes MFA amb els IDs donats.| |selectUsrgrps|query|Retorna una propietat `usrgrps` amb [grups d'usuaris](/manual/api/reference/usergroup/object) associats amb els mètodes MFA.<br><br>Admet `count`.| |filter|object|Retorna només resultats que coincideixen exactament amb el filtre donat.<br><br>Admet un objecte, on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar. <br><br>Admet les propietats:<br>`mfaid` - ID del mètode MFA;<br>`type` - Tipus del mètode MFA.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Valors possibles: `name`.| |search|object|Retorna el resultat que coincideix amb el patró donat (sensible a majúscules i minúscules).<br><br>Valors possibles: `name`.| |countOutput|boolean|Com que aquests paràmetres són comuns a tots els mètodes `get`, es descriuen detalladament a [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mfaids|ID/array|Return only user groups with the given MFA methods.| |mfa_status|integer|Return only user groups with the given MFA status.<br><br>Refer to the [user group page](object#user_group) for a list of supported statuses.| |status|integer|Return only user groups with the given status.<br><br>Refer to the [user group page](object#user_group) for a list of supported statuses.| |userids|ID/array|Return only user groups that contain the given users.| |usrgrpids|ID/array|Return only user groups with the given IDs.| |selectTagFilters|query|Return user group tag-based permissions in the [`tag_filters`](/manual/api/reference/usergroup/object#tag_based_permission) property.| |selectUsers|query|Return the users from the user group in the [`users`](/manual/api/reference/user/object#user) property.| |selectHostGroupRights|query|Return user group host group [permissions](/manual/api/reference/usergroup/object#permission) in the `hostgroup_rights` property.<br><br>Refer to the [user group page](object#permission) for a list of access levels to host groups.| |selectTemplateGroupRights|query|Return user group template group [permissions](/manual/api/reference/usergroup/object#permission) in the `templategroup_rights` property.<br><br>Refer to the [user group page](object#permission) for a list of access levels to template groups.| |limitSelects|integer|Limits the number of records returned by subselects.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `usrgrpid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectRights<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroupRights` or `selectTemplateGroupRights` instead.<br>Return user group rights in the [`rights`](/manual/api/reference/usergroup/object#permission) property.<br>Refer to the [user group page](object#permission) for a list of access levels to host groups.|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |mfaids|ID/array|Retorna només els grups d'usuaris amb els mètodes MFA donats.| |mfa_status|integer|Retorna només els grups d'usuaris amb l'estat MFA donat.<br><br>Veieu la [pàgina de grups d'usuaris](object#user_group) per tindre una llista d'estats admesos.| |status|integer|Retorna només els grups d'usuaris amb l'estat donat.<br><br>Consulteu la pàgina de [grup d'usuaris](object#user_group) per obtindre una llista d'estats admesos. |userids|ID/array|Retorna només els grups d'usuaris que contenen els usuaris especificats.| |usrgrpids|ID/array|Retorna només els grups d'usuaris amb els ID donats.| |selectTagFilters|query|Retorna els permisos basats en etiquetes de grup d'usuaris a la propietat [`tag_filters`](/manual/api/reference/usergroup/object#tag_based_permission).| |selectUsers|query|Retorna els usuaris del grup d'usuaris a la propietat [`users`](/manual/api/reference/user/object#user).| |selectHostGroupRights|query|Retorna els permisos del grup d'usuaris del grup de [permisos](/manual/api/reference/usergroup/object#permission) a la propietat `hostgroup_rights`.<br><br>Consulteu [pàgina del grup d'usuaris](object#permission) per obtindre una llista dels nivells d'accés del grup d'equips.| |selectTemplateGroupRights|query|Retorna els permisos del grup de [permisos](/manual/api/reference/usergroup/object#permission) a la propietat `templategroup_rights`.<br><br>Consulteu la [pàgina del grup d'usuaris](object#permission) per obtindre una llista dels nivells d'accés del grup de plantilles.| |limitSelects|integer|Limita el nombre de registres retornats per subseleccions.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `usrgrpid`, `name`.| |countOutput|boolean|Aquests paràmetres comuns a tots els mètodes `get` es descriuen amb detall a la pàgina [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectRights<br>(obsolet)|query|Aquest paràmetre és obsolet; si us plau, empreu `selectHostGroupRights` o `selectTemplateGroupRights`.<br>Retorna els drets del grup d'usuaris a la propietat [`rights`](/manual/api/reference/usergroup/object#permission).<br><br>Veieu la [pàgina de grups d'usuaris](object#permission) per tindre una llista de nivells d'accés dels grups d'equips.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |moduleids|ID/array|Return only modules with the given IDs.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `moduleid`, `relative_path`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [Reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |moduleids|ID/array|Retorna només mòduls amb els identificadors donats.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Valors possibles: `moduleid`, `relative_path`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |proxy_groupids|ID/array|Return only proxy groups with the given IDs.| |proxyids|ID/array|Return only proxy groups that contain the given proxies.| |selectProxies|query|Return a [`proxies`](/manual/api/reference/proxy/object) property with the proxies that belong to the proxy group.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `proxy_groupid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(objecte)` Paràmetres que defineixen la sortida desitjada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |proxy_groupids|ID/array|Retorna només els grups de proxy amb els ID donats.| |proxyids|ID/array|Retorna només els grups de proxys que contenen els proxys donats.| |selectProxies|query|Retorna una propietat [`proxies`](/manual/api/reference/proxy/object) amb els proxys que pertanyen al grup de proxys.<br><br>Admet `count`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `proxy_groupid`, `name`.| |countOutput|boolean|Aquests paràmetres que són comuns per a tots els mètodes `get` es descriuen amb detall al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |proxyids|ID/array|Return only proxies with the given IDs.| |selectAssignedHosts|query|Return an [`assignedHosts`](/manual/api/reference/host/object) property with the hosts assigned to the proxy.<br><br>Supports `count`.| |selectHosts|query|Return a [`hosts`](/manual/api/reference/host/object) property with the hosts monitored by the proxy.<br><br>Supports `count`.| |selectProxyGroup|query|Return a [`proxyGroup`](/manual/api/reference/proxygroup/object) property with the proxy group object.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `proxyid`, `name`, `operating_mode`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |proxyids|ID/array|Retorna només proxys amb els identificadors donats.| |selectAssignedHosts|query|Retorna una propietat [`assignedHosts`](/manual/api/reference/host/object) amb els equips assignats al proxy.<br><br>Admet `count`.| |selectHosts|query|Retorna una propietat [`hosts`](/manual/api/reference/host/object) amb els equips monitorats pel proxy.| |selectProxyGroup|query|Retorna una propietat [`proxyGroup`](/manual/api/reference/proxygroup/object) amb l'objecte del grup de proxys.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `proxyid`, `name` i `operating_mode`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |regexpids|ID/array|Return only regular expressions with the given IDs.| |selectExpressions|query|Return an [`expressions`](/manual/api/reference/regexp/object#expressions) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `regexpid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(objet)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |regexpids|ID/array|Retorna només expressions regulars amb els identificadors donats.| |selectExpressions|query|Retorna una propietat [expressions](/manual/api/reference/regexp/object#expressions_object).| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Valors possibles: `regexpid`, `name`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |reportids|ID/array|Return only scheduled reports with the given report IDs.| |expired|boolean|If set to `true` returns only expired scheduled reports, if `false` - only active scheduled reports.| |selectUsers|query|Return a [`users`](/manual/api/reference/user/object) property the report is configured to be sent to.| |selectUserGroups|query|Return a [`user_groups`](/manual/api/reference/user/object) property the report is configured to be sent to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `reportid`, `name`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |reportids|ID/array|Retorna només els informes programats amb els IDs donats.| |expired|boolean|Si s'estableix a `true` retorna només els informes programats expirats; si `false` - només els informes programats actius.| |selectUsers|query|Retorna la propietat [`users`](/manual/api/reference/user/object) a qui s'ha configurat d'enviar l'informe.| |selectUserGroups|query|Retorna la propietat [`user_groups`](/manual/api/reference/user/object) a qui s'ha configurat d'enviar l'informe.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `reportid`, `name`, `status`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen en detall a la pàgina [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |roleids|ID/array|Return only roles with the given IDs.| |selectRules|query|Return a [`rules`](/manual/api/reference/role/object#role_rules) property with the role rules.| |selectUsers|query|Return a [`users`](/manual/api/reference/user/object) property with the users that the role is assigned to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `roleid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |roleids|ID/array|Retorna només els rols amb els ID donats.| |selectRules|query|Retorna les regles de rol a la propietat [`rules`](/manual/api/reference/role/object#role_rules).| |selectUsers|query|Retorna els [`users`](/manual/api/reference/user/object) als quals és assignada aquesta funció.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `roleid`, `name`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |serviceids|ID/array|Return only services with the given IDs.| |parentids|ID/array|Return only services that are linked to the given parent services.| |deep\_parentids|flag|Return all direct and indirect child services. Used together with `parentids`.| |childids|ID/array|Return only services that are linked to the given child services.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.| |tags|object/array|Return only services with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all services.<br><br>Possible operator values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.| |problem\_tags|object/array|Return only services with given problem tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all services.<br><br>Possible operator values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.| |without\_problem\_tags|flag|Return only services without problem tags.| |slaids|ID/array|Return only services that are linked to the specific SLA(s).| |selectChildren|query|Return a `children` property with the child services.<br><br>Supports `count`.| |selectParents|query|Return a `parents` property with the parent services.<br><br>Supports `count`.| |selectTags|query|Return a [`tags`](/manual/api/reference/service/object#service_tag) property with service tags.<br><br>Supports `count`.| |selectProblemEvents|query|Return a `problem_events` property with an array of problem event objects.<br><br>The problem event object has the following properties:<br>`eventid` - `(ID)` Event ID;<br>`severity` - `(string)` Current event severity;<br>`name` - `(string)` Resolved event name.<br><br>Supports `count`.| |selectProblemTags|query|Return a [`problem_tags`](/manual/api/reference/service/object#problem_tag) property with problem tags.<br><br>Supports `count`.| |selectStatusRules|query|Return a [`status_rules`](/manual/api/reference/service/object#status_rule) property with status rules.<br><br>Supports `count`.| |selectStatusTimeline|object/array|Return a `status_timeline` property containing service state changes for given periods.<br><br>Format `[{"period_from": "<period_from>", "period_to": "<period_to>"}, ...]` - `period_from` being a starting date (inclusive; integer timestamp) and `period_to` being an ending date (exclusive; integer timestamp) for the period you're interested in.<br><br>Returns an array of entries containing a `start_value` property and an [`alarms`](/manual/api/reference/service/object#service-alarm) array for the state changes within specified periods.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `serviceid`, `name`, `status`, `sortorder`, `created_at`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(objecte)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |serviceids|ID/array|Retorna només serveis amb els ID donats.| |parentids|ID/array|Retorna només els serveis que són enllaçats als serveis pare donats.| |deep\_parentids|flag|Retorna tots els serveis secundaris directes i indirectes. S'empra juntament amb `parentids`.| |childids|ID/array|Retorna només els serveis que són enllaçats als serveis secundaris donats.| |evaltype|enter|Regles per a la cerca d'etiquetes.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.| |tags|objecte/matriu d'objectes|Retorn només serveis amb etiquetes donades. Concordança exacta per etiqueta i cerca que distingeix entre majúscules i majúscules o minúscules per valor de l'etiqueta en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "value": "<valor>", " operator": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els serveis.<br><br>Possibles valors d'operador:<br>0 - *(per defecte)* Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.| |problem\_tags|objecte/matriu d'objectes|Retorn només serveis amb etiquetes de problema donades. Concordança exacta per etiqueta i cerca que distingeix entre majúscules i majúscules o minúscules per valor de l'etiqueta en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "valor": "<valor>", " operator": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els serveis.<br><br>Possibles valors d'operador:<br>0 - *(per defecte)* Conté;<br >1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.| |without\_problem\_tags|bandera|Retorn només serveis sense etiquetes de problema.| |slaids|ID/array|Retorna només els serveis que són enllaçats amb els SLA específics.| |selectChildren|query|Retorna una propietat `fills` amb els serveis secundaris.<br><br>Admet `count`.| |selectParents|query|Retorna una propietat `parents` amb els serveis parentals.<br><br>Admet `count`.| |selectTags|query|Retorna una propietat [`tags`](/manual/api/reference/service/object#service_tag) amb etiquetes de servei.<br><br>Admet `count`.| |selectProblemEvents|query|Retorna una propietat `problem_events` amb una matriu d'objectes d'esdeveniment problema.<br><br>L'objecte d'esdeveniment problema té les propietats següents:<br>`eventid` - `(cadena)` Identificador d'esdeveniment;< br>`gravetat` - `(cadena)` Gravetat de l'esdeveniment actual;<br>`nom` - `(cadena)` Nom de l'esdeveniment resolt.<br><br>Admet `count`.| |selectProblemTags|query|Retorna una propietat [`problem_tags`](/manual/api/reference/service/object#problem_tag) amb etiquetes de problema.<br><br>Admet `count`.| |selectStatusRules|query|Retorna una propietat [`status_rules`](/manual/api/reference/service/object#status_rule) amb regles d'estat.<br><br>Admet `count`.| |selectStatusTimeline|objecte/matriu d'objectes|Retorna una propietat `status_timeline` que conté canvis d'estat del servei per a períodes determinats.<br><br>Format `[{"period_from": "<period_from>", "period_to": "<period_to >"}, ...]` - `period_from` és una data d'inici (inclosa; marca de temps entera) i `period_to` és una data de finalització (exclusiu; marca de temps enter) per al període que t'interessa.<br>< br>Retorna una matriu d'entrades que contenen una propietat `start_value` i una matriu [alarmes](/manual/api/reference/service/object#service-alarm) per als canvis d'estat dins dels períodes especificats.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `serviceid`, `name`, `status`, `sortorder`, `created_at`.| |countOutput|boolean|Aquests paràmetres que són comuns per a tots els mètodes `get` es descriuen amb detall al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|booleà|^| |excludeSearch|booleà|^| |filter|objecte|^| |limit|enter|^| |output|consulta|^| |preservekeys|boolean|^| |search|objecte|^| |searchByAny|booleà|^| |searchWildcardsEnabled|booleà|^| |sortorder|cadena/matriu|^| |startSearch|booleà|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |slaids|ID/array|Return only SLAs with the given IDs.| |serviceids|ID/array|Return only SLAs matching the specific services.| |selectSchedule|query|Return a `schedule` property with SLA schedules.<br><br>Supports `count`.| |selectExcludedDowntimes|query|Return an `excluded_downtimes` property with SLA excluded downtimes.<br><br>Supports `count`.| |selectServiceTags|query|Return a `service_tags` property with SLA service tags.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status`, `description`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(objecte)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |slaids|ID/array|Retorna només SLA amb els ID donats.| |serviceids|ID/array|Retorna només els SLA que coincideixen amb els serveis específics.| |selectSchedule|query|Retorna una propietat `schedule` amb programacions de SLA.<br><br>Admet `count`.| |selectExcludedDowntimes|query|Retorna una propietat `excluded_downtimes` amb els temps d'inactivitat SLA exclosos.<br><br>Admet `count`.| |selectServiceTags|query|Retorna una propietat `service_tags` amb etiquetes de servei SLA.<br><br>Admet `count`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status `, `description`.| |countOutput|boolean|Aquests paràmetres que són comuns per a tots els mètodes `get` es descriuen amb detall al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapids|ID/array|Returns only maps with the given IDs.| |userids|ID/array|Returns only maps that belong to the given user IDs.| |expandUrls|flag|Adds global map URLs to the corresponding map elements and expands macros in all map element URLs.| |selectIconMap|query|Returns an [`iconmap`](/manual/api/reference/iconmap/object) property with the icon map used on the map.| |selectLinks|query|Returns a [`links`](/manual/api/reference/map/object#Map_link) property with the map links between elements.| |selectSelements|query|Returns a [`selements`](/manual/api/reference/map/object#map_element) property with the map elements.| |selectUrls|query|Returns a [`urls`](/manual/api/reference/map/object#Map_URL) property with the map URLs.| |selectUsers|query|Returns a [`users`](/manual/api/reference/map/object#Map_user) property with users that the map is shared with.| |selectUserGroups|query|Returns a [`userGroups`](/manual/api/reference/map/object#Map_user_group) property with user groups that the map is shared with.| |selectShapes|query|Returns a [`shapes`](/manual/api/reference/map/object#Map_shapes) property with the map shapes.| |selectLines|query|Returns a [`lines`](/manual/api/reference/map/object#Map_lines) property with the map lines.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `name`, `width`, `height`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapids|ID/array|Retorna només mapes amb els identificadors donats.| |userids|ID/array|Retorna només les targes que pertanyen als ID d'usuari donats.| |expandUrls|flag|Afegeix URL de mapa global als elements de mapa corresponents i amplia les macros a totes les URL d'elements de mapa.| |selectIconMap|query|Retorna la propietat [mapa d'icones](/manual/api/reference/iconmap/object) que conté els mapes d'icones emprats al mapa.| |selectLinks|query|Retorna la propietat [enllaçps](/manual/api/reference/map/object#Map_link) que conté els enllaços del mapa entre els elements.| |selectSelements|query|Retorna la propietat [selements](/manual/api/reference/map/object#map_element) que conté els elements del mapa.| |selectUrls|query|Retorna la propietat [urls](/manual/api/reference/map/object#Map_URL) que conté els URL del mapa.| |selectUsers|query|Retorna la propietat [usuaris](/manual/api/reference/map/object#Map_user) que conté els usuaris amb els quals es comparteix el mapa.| |selectUserGroups|query|Retorna la propietat [grups d'usuaris](/manual/api/reference/map/object#Map_user_group) que conté els grups d'usuaris amb què es comparteix el mapa.| |selectShapes|query|Retorna la propietat [formes](/manual/api/reference/map/object#Map_shapes) que conté les formes del mapa.| |selectLines|query|Retorna la propietat [línies](/manual/api/reference/map/object#Map_lines) que conté les línies del mapa.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `name`, `width` i `height`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |taskids|ID/array|Return only tasks with the given IDs.| |output|query|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |preservekeys|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents. |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |taskids|ID/array|Retorna només tasques amb els ID donats.| |output|query|Aquests paràmetres que són comuns a tots els mètodes `get` es descriuen amb detall a [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |preservekeys|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |templateids|ID/array|Return only templates with the given template IDs.| |groupids|ID/array|Return only templates that belong to the given template groups.| |parentTemplateids|ID/array|Return only templates that the given template is linked to.| |hostids|ID/array|Return only templates that are linked to the given hosts/templates.| |graphids|ID/array|Return only templates that contain the given graphs.| |itemids|ID/array|Return only templates that contain the given items.| |triggerids|ID/array|Return only templates that contain the given triggers.| |with\_items|flag|Return only templates that have items.| |with\_triggers|flag|Return only templates that have triggers.| |with\_graphs|flag|Return only templates that have graphs.| |with\_httptests|flag|Return only templates that have web scenarios.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|object/array|Return only templates with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all templates.<br><br>Possible operator values:<br>0 - (default) Contains;<br>1 - Equals;<br>2 - Not like;<br>3 - Not equal;<br>4 - Exists;<br>5 - Not exists.| |selectTags|query|Return template tags in the [`tags`](/manual/api/reference/template/object#template_tag) property.| |selectHosts|query|Return the hosts that are linked to the template in the [`hosts`](/manual/api/reference/host/object) property.<br><br>Supports `count`.| |selectTemplateGroups|query|Return the template groups that the template belongs to in the [`templategroups`](/manual/api/reference/templategroup/object) property.| |selectTemplates|query|Return templates to which the given template is linked in the [`templates`](/manual/api/reference/template/object) property.<br><br>Supports `count`.| |selectParentTemplates|query|Return templates that are linked to the given template in the `parentTemplates` property.<br><br>Supports `count`.| |selectHttpTests|query|Return the web scenarios from the template in the [`httpTests`](/manual/api/reference/httptest/object) property.<br><br>Supports `count`.| |selectItems|query|Return items from the template in the [`items`](/manual/api/reference/item/object) property.<br><br>Supports `count`.| |selectDiscoveries|query|Return low-level discoveries from the template in the `discoveries` property.<br><br>Supports `count`.| |selectTriggers|query|Return triggers from the template in the [`triggers`](/manual/api/reference/trigger/object) property.<br><br>Supports `count`.| |selectGraphs|query|Return graphs from the template in the [`graphs`](/manual/api/reference/graph/object) property.<br><br>Supports `count`.| |selectMacros|query|Return the macros from the template in the `macros` property.| |selectDashboards|query|Return dashboards from the template in the [`dashboards`](/manual/api/reference/templatedashboard/object) property.<br><br>Supports `count`.| |selectValueMaps|query|Return a [`valuemaps`](/manual/api/reference/valuemap/object) property with template value maps.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectTemplates` - results will be sorted by `name`;<br>`selectHosts` - sorted by `host`;<br>`selectParentTemplates` - sorted by `host`;<br>`selectItems` - sorted by `name`;<br>`selectDiscoveries` - sorted by `name`;<br>`selectTriggers` - sorted by `description`;<br>`selectGraphs` - sorted by `name`;<br>`selectDashboards` - sorted by `name`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectTemplateGroups` instead.<br>Return the template groups that the template belongs to in the [`groups`](/manual/api/reference/templategroup/object) property.|
ca	### Paramètres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |templateids|ID/array|Retorna només plantilles amb els ID de plantilla donats.| |groupids|ID/array|Retorna només els patrons que pertanyen als grups d'equips donats.| |parentTemplateids|string/array|Retorna només les plantilles que són pares de les plantilles donades.| |hostids|ID/array|Retorna només patrons relacionats amb els hosts/patrons donats.| |graphids|ID/array|Retorna només els models que contenen els gràfics donats.| |itemids|ID/array|Retorna només els models que contenen els elements donats.| |triggerids|ID/array|Retorna només els patrons que contenen els triggers donats.| |with\_items|flag|Retorna només models amb articles.| |with\_triggers|flag|Retorna només els models que tenen triggers.| |with\_graphs|flag|Retorna només models que contenen gràfics.| |with\_httptests|marca|Retorna només models que tenen escenaris web.| |evaltype|integer|Regles de cerca d'etiquetes.<br><br>Valors possibles:<br>0 - (per defecte) I/O;<br>2 - O.| |tags|array/objecte|Retorna només models amb etiquetes donades. Concordança exacta per etiqueta i cerca entre majúscules i minúscules o no per valor de l'etiqueta en funció del valor de l'operador.<br>Format:`[{"tag": "<etiqueta>", "valor": "< valor>", " operator": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els models.<br><br>Possibles valors d'operador:<br>0 - (per defecte) Conté;<br>1 - És igual;<br>2 - No és com;<br>3 - No és igual< br>4 - Existeix;<br>5 - No existeix.| |selectTags|query|Retorna les etiquetes de plantilla a la propietat [etiquetes](/manual/api/reference/template/object#template_tag).| |selectHosts|query|Retorna els equips vinculats al model a la propietat [equips](/manual/api/reference/host/object).<br><br>Admet `count`.| |selectTemplateGroups|query|Retorna els grups de plantilles als quals pertany la plantilla a la propietat [`templategroups`](/manual/api/reference/templategroup/object).| |selectTemplates|query|Retorna les plantilles de les quals la plantilla és secundària, a la propietat [`templates`](/manual/api/reference/template/object).<br><br>Admet `count`.| |selectParentTemplates|query|Retorna les plantilles de les quals la plantilla n'és pare, a la propietat `parentTemplates`.<br><br>Admet `count`.| |selectHttpTests|query|Retorna els escenaris web del model a la propietat [httpTests](/manual/api/reference/httptest/object).<br><br>Admet `count`.| |selectItems|query|Retorna els elements del model a la propietat [elements](/manual/api/reference/item/object).<br><br>Admet `count`.| |selectDiscoveries|query|Retorna els descobriments de baix nivell del model a la propietat `discoveries`.<br><br>Admet `count`.| |selectTriggers|query|Retorna triggers del model a la propietat [triggers](/manual/api/reference/trigger/object).<br><br>Admet `count`.| |selectGraphs|query|Retorna gràfics del model a la propietat [gràfics](/manual/api/reference/graph/object).<br><br>Admet `count`.| |selectMacros|query|Retorna macros del model a la propietat `macros`.| |selectDashboards|query|Retorna els taulers de control de la plantilla a la propietat [taulers de control](/manual/api/reference/templedashboard/object).<br><br>Admet `count`.| |selectValueMaps|query|Retorna una propietat [valuemaps](/manual/api/reference/valuemap/object) amb taules d'assignació de valors del model.| |limitSelects|integer|Limita el nombre de registres retornats per subseleccions.<br><br> S'aplica a les subseleccions següents:<br>`selectTemplates` - els resultats s'ordenaran per `name`;< br>`selectHosts` - ordenats per `host`; <br>`selectParentTemplates` - ordenat per `host`;<br>`selectItems` - ordenat per `name`;<br>`selectDiscoveries` - ordenat per `name`;<br>`selectTriggers` - ordenat per `description`;<br>`selectGraphs` - ordenat per `name`;<br>`selectDashboards` - ordenat per `name`.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `hostid`, `host`, `name`, `status`.| |countOutput|boolean|Aquests paràmetres comuns a tots els mètodes `get` es descriuen amb detall a la pàgina [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si et plau, empra `selectTemplateGroups` en el seu lloc.<br>Retorna els grups de plantilles als que pertany la plantilla a la propietat [`groups`](/manual/api/reference/templategroup/object).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tokenids|ID/array|Return only tokens with the given IDs.| |userids|ID/array|Return only tokens created for the given users.| |token|string|Return only tokens created for the given *Auth token*.| |valid\_at|timestamp|Return only tokens, which are valid (not expired) at the given date and time.| |expired\_at|timestamp|Return only tokens, which are expired (not valid) at the given date and time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `tokenid`, `name`, `lastaccess`, `status`, `expires_at`, `created_at`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tokenids|ID/array|Retorna només tokens amb els ID donats.| |userids|ID/array|Retorna només els tokens creats per als usuaris donats.| |token|string|Retorna només els tokens creats per al *token d'autenticació* donat.| |valid\_at|timestamp|Retorna només tokens vàlids (no caducats) a la data i hora indicades.| |expired\_at|timestamp|Retorna només els tokens que han caducat (no vàlids) a la data i hora donades.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `tokenid`, `name`, `lastaccess`, `status`, `expires_at` i `created_at `. | |countOutput|boolean|Aquests paràmetres comuns a tots els mètodes `get` es descriuen en detall a la pàgina [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |triggerids|ID/array|Return only triggers with the given IDs.| |groupids|ID/array|Return only triggers that belong to hosts or templates from the given host groups or template groups.| |templateids|ID/array|Return only triggers that belong to the given templates.| |hostids|ID/array|Return only triggers that belong to the given hosts.| |itemids|ID/array|Return only triggers that contain the given items.| |functions|string/array|Return only triggers that use the given functions.<br><br>Refer to the [supported function](/manual/appendix/functions) page for a list of supported functions.| |group|string|Return only triggers that belong to hosts or templates from the host group or template group with the given name.| |host|string|Return only triggers that belong to host with the given technical name.| |inherited|boolean|If set to `true` return only triggers inherited from a template.| |templated|boolean|If set to `true` return only triggers that belong to templates.| |dependent|boolean|If set to `true` return only triggers that have dependencies. If set to `false` return only triggers that do not have dependencies.| |monitored|flag|Return only enabled triggers that belong to monitored hosts and contain only enabled items.| |active|flag|Return only enabled triggers that belong to monitored hosts.| |maintenance|boolean|If set to `true` return only enabled triggers that belong to hosts in maintenance.| |withUnacknowledgedEvents|flag|Return only triggers that have unacknowledged events.| |withAcknowledgedEvents|flag|Return only triggers with all events acknowledged.| |withLastEventUnacknowledged|flag|Return only triggers with the last event unacknowledged.| |skipDependent|flag|Skip triggers in a problem state that are dependent on other triggers. Note that the other triggers are ignored if disabled, have disabled items or disabled item hosts.| |lastChangeSince|timestamp|Return only triggers that have changed their state after the given time.| |lastChangeTill|timestamp|Return only triggers that have changed their state before the given time.| |only\_true|flag|Return only triggers that have recently been in a problem state.| |min\_severity|integer|Return only triggers with severity greater or equal than the given severity.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array|Return only triggers with given tags. Exact match by tag and case-sensitive or case-insensitive search by tag value depending on operator value.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all triggers.<br><br>Possible operator types:<br>0 - (default) Like;<br>1 - Equal;<br>2 - Not like;<br>3 - Not equal;<br>4 - Exists;<br>5 - Not exists.| |expandComment|flag|Expand macros in the trigger description.| |expandDescription|flag|Expand macros in the name of the trigger.| |expandExpression|flag|Expand functions and macros in the trigger expression.| |selectHostGroups|query|Return the host groups that the trigger belongs to in the [`hostgroups`](/manual/api/reference/hostgroup/object) property.| |selectHosts|query|Return the hosts that the trigger belongs to in the [`hosts`](/manual/api/reference/host/object) property.| |selectItems|query|Return items contained by the trigger in the [`items`](/manual/api/reference/item/object) property.| |selectFunctions|query|Return functions used in the trigger in the `functions` property.<br><br>The function objects represent the functions used in the trigger expression and has the following properties:<br>`functionid` - `(ID)` ID of the function;<br>`itemid` - `(ID)` ID of the item used in the function;<br>`function` - `(string)` name of the function;<br>`parameter` - `(string)` parameter passed to the function. Query parameter is replaced by `$` symbol in returned string.| |selectDependencies|query|Return triggers that the trigger depends on in the `dependencies` property.| |selectDiscoveryRule|query|Return the [low-level discovery rule](/manual/api/reference/discoveryrule/object#discovery_rule) that created the trigger in the `discoveryRule` property.| |selectLastEvent|query|Return the last significant trigger event in the [`lastEvent`](/manual/api/reference/event/object) property.| |selectTags|query|Return the trigger tags in [`tags`](/manual/api/reference/trigger/object#Trigger_tag) property.| |selectTemplateGroups|query|Return the template groups that the trigger belongs to in the [`templategroups`](/manual/api/reference/templategroup/object) property.| |selectTriggerDiscovery|query|Return the trigger discovery object in the `triggerDiscovery` property. The trigger discovery objects link the trigger to a trigger prototype from which it was created.<br><br>It has the following properties:<br>`parent_triggerid` - `(ID)` ID of the trigger prototype from which the trigger has been created;<br>`status` - `(int)` trigger discovery status:<br>0 - *(default)* trigger is discovered,<br>1 - trigger is not discovered anymore;<br>`ts_delete` - `(timestamp)` time when a trigger that is no longer discovered will be deleted;<br>`ts_disable` - `(timestamp)` time when a trigger that is no longer discovered will be disabled;<br>`disable_source` - `(int)` indicator of whether trigger was disabled by an LLD rule or manually:<br>0 - *(default)* disabled automatically,<br>1 - disabled by an LLD rule.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Does not support properties of `text` [data type](/manual/api/reference_commentary#data-types).<br><br>Supports additional properties:<br>`host` - technical name of the host that the trigger belongs to;<br>`hostid` - ID of the host that the trigger belongs to.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - results will be sorted by `host`.| |sortfield|string/array|[Sort](/manual/api/reference_commentary#common_get_method_parameters) the result by the given properties.<br><br>Possible values: `triggerid`, `description`, `status`, `priority`, `lastchange`, `hostname`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters) page.| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` or `selectTemplateGroups` instead.<br>Return the host groups and template groups that the trigger belongs to in the `groups` property.|
ca	### Paràmetres  `(object)` Paràmetres definint la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |triggerids|ID/array|Retorna només triggers amb els identificadors donats.| |groupids|ID/array|Retorna només triggers que pertanyen als equips dels grups d'equips donats.| |templateids|ID/array|Retorna només triggers que pertanyen a les plantilles donades.| |hostids|ID/array|Retorna només triggers que pertanyen als equips donats.| |itemids|ID/array|Retorna només triggers que contenen els elements donats.| |functions|string/array|Retorna només triggers que empren les funcions donades.<br><br>Consulteu la pàgina [funcions de triggers admeses](/manual/appendix/triggers/functions) per obtindre una llista de funcions admeses.| |group|string|Retorna només triggers que pertanyen als equips del grup d'equips amb el nom donat.| |host|string|Retorna només triggers pertanyents a l'equip amb el nom tècnic donat.| |inherited|boolean|Si es defineix com a `true`, només retorna triggers heretats d'una plantilla.| |template|boolean|Si s'estableix a `true`, només retorna triggers que pertanyen a plantilles.| |dependent|boolean|Si s'estableix a `true`, només retorna triggers que tenen dependències. Si s'estableix a `fals', només retorna triggers que no tenen dependències.| |monitored|flag|Retorna només triggers activats que pertanyen als equips monitorats i que només contenen elements activats.| |active|flag|Retorna només triggers activats que pertanyen als equips monitorats.| |maintenance|boolean|Si s'estableix a `true`, només retorna triggers activats que pertanyen als equips en manteniment.| |withUnacknowledgedEvents|flag|Retorna només triggers que tenen esdeveniments no reconeguts.| |withAcknowledgedEvents|flag|Retorna només triggers amb tots els esdeveniments reconeguts.| |withLastEventUnacknowledged|flag|Retorna només triggers amb el darrer esdeveniment no reconegut.| |skipDependent|flag|Omet els triggers en un estat problemàtic que depenen d'altres triggers. Tingueu en compte que altres triggers s'ignoren si són desactivats, tenen elements desactivats o tenen equips d'elements desactivats.| |lastChangeSince|timestamp|Retorna només els triggers que han canviat d'estat després del temps d'espera.| |lastChangeTill|timestamp|Retorna només els triggers que han canviat d'estat abans de l'hora especificada.| |només\_true|flag|Retorna només els triggers que han tingut un problema recentment.| |min\_severity|enteger|Retorna només triggers amb una gravetat superior o igual a la gravetat donada.| |evaltype|integer|Regles per a la cerca d'etiquetes.<br><br>Valors possibles:<br>0 - (per defecte) I/O;<br>2 - O.| |tags|array of objects|Retorna només triggers amb les etiquetes donades. Concordança exacta per etiqueta i cerca per etiqueta distingeix entre majúscules i minúscules o no distingeix entre majúscules i minúscules en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "valor": "< valor>", "operador". ": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els triggers.<br><br>Tipus d'operadors possibles:<br>0 - (per defecte) És com;<br>1 - Igual;<br>2 - No és com;<br>3 - No és igual; <br>4 - Existeix;<br>5 - No existeix.| |expandComment|flag|Amplieu les macros a la descripció del trigger.| |expandDescription|flag|Amplieu les macros al nom del trigger.| |expandExpression|flag|Amplieu macros i funcions a l'expressió del trigger.| |selectHostGroups|query|Retorna els grups d'equips als quals pertany el trigger a la propietat [hostgrups](/manual/api/reference/hostgroup/object).| |selectHosts|query|Retorna els equips als quals pertany el trigger a la propietat [equips](/manual/api/reference/host/object).| |selectItems|query|Retorna els elements continguts al trigger a la propietat [elements](/manual/api/reference/item/object).| |selectFunctions|query|Retorna les funcions emprades al trigger a la propietat `functions`.<br><br>Els objectes de funció representen les funcions emprades a l'expressió trigger i tenen les propietats següents:<br>`functionid` - `(ID)` ID de la funció;<br>`itemid` - `(ID)` ID de l'element emprat a la funció;<br>`function` - `(string)` nom de la funció; <br>` parameter` - `(string)` paràmetre passat a la funció. El paràmetre de consulta es substitueix pel símbol `$` a la cadena retornada.| |selectDependencies|query|Retorna els triggers dels quals depèn el trigger a la propietat `dependencies`.| |selectDiscoveryRule|query|Retorna la [regla de descobriment de baix nivell](/manual/api/reference/discoveryrule/object#discovery_rule) que ha creat el trigger.| |selectLastEvent|query|Retorna el darrer esdeveniment de trigger significatiu a la propietat [lastEvent](/manual/api/reference/event/objecte).| |selectTags|query|Retorna les etiquetes de trigger a la propietat [etiquetes](/manual/api/reference/trigger/object#Trigger_tag).| |selectTemplateGroups|query|Retorna els grups de plantilles als quals pertany el trigger a la propietat [templategrups](/manual/api/reference/templategroup/object).| |selectTriggerDiscovery|query|Retorna l'objecte de descoberta del trigger a la propietat `triggerDiscovery`. Els objectes de descobriment del trigger emllaçen el trigger a un prototip de trigger a partir del qual s'ha creat.<br><br>Té les propietats següents:<br>`parent_triggerid` - `(cadena)` ID del prototip de trigger des del qual s'ha creat el trigger.| |filter|object|Només retorna resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta una matriu on les claus són noms de propietat i els valors són un valor únic o una matriu de valors per comparar.< br>\\\\Admet filtres addicionals:<br>`host` - nom tècnic de l'equip al qual pertany el trigger;<br>`hostid` - ID de l'equip al qual pertany el trigger.| |limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subseleccions següents:<br>`selectHosts`: els resultats s'ordenaran per `host`.| |sortfield|string/array|[Ordena](/fr/manual/api/reference_commentary#Common_parameters_of_the_get_method) el resultat per les propietats donades.<br><br>Valors possibles: `triggerid`, `description`, `status`, `priority`, `lastchange` i `hostname`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si us plau, emprau `selectHostGroups` o `selectTemplateGroups` en el seu lloc.<br>Retorna els grups d'equips i els grups de plantilles on el trigger pertany a la propietat `groups`.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |userdirectoryids|ID/array|Return only user directories with the given IDs.| |selectUsrgrps|query|Return a `usrgrps` property with [user groups](/manual/api/reference/usergroup/object) associated with a user directory.<br><br>Supports `count`.| |selectProvisionMedia|query|Return a `provision_media` property with [media type mappings](/manual/api/reference/userdirectory/object#media-type-mappings) associated with a user directory.| |selectProvisionGroups|query|Return a `provision_groups` property with [provisioning groups mappings](/manual/api/reference/userdirectory/object#provisioning-groups-mappings) associated with a user directory.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `name`.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an object, where the keys are property names, and the values are either a single value or an array of values.<br><br>Supports properties: `userdirectoryid`, `idp_type`, `provision_status`.| |search|object|Return results that match the given pattern (case-insensitive).<br><br>Accepts an object, where the keys are property names, and the values are strings to search for. If no additional options are given, this will perform a `LIKE "%…%"` search.<br><br>Supports properties: `name`, `description`.<br><br>User directory of type SAML will have an empty value for both `name` and `description` properties. Both properties can be changed with the `userdirectory.update` operation.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(objecte)` Paràmetres que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |userdirectoryids|ID/array|Retorna només els directoris d'usuari amb els ID donats.| |selectUsrgrps|query|Retorna una propietat `usrgrps` amb [grups d'usuaris](/manual/api/reference/usergroup/object) associats a un directori d'usuaris.<br><br>Admet `count`.| |selectProvisionMedia|query|Retorna una propietat `provision_media` amb [mapatges de tipus de suport](/manual/api/reference/userdirectory/object#media-type-mappings) associat a un directori d'usuari.| |selectProvisionGroups|query|Retorna una propietat `provisioning_groups` amb [mapatges de grups d'aprovisionament](/manual/api/reference/userdirectory/object#provisioning-groups-mappings) associada a un directori d'usuari.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `name`.| |filter|object|Retorna només els resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta un objecte, on les claus són els noms de propietat i els valors són un valor únic o una matriu de valors.<br> <br>Claus admeses: `userdirectoryid`, `idp_type`, `provision_status`.| |search|object|Retorna resultats que coincideixen amb el patró donat (no distingeix entre majúscules i minúscules).<br><br>Admet un objecte, on la clau és nom de la propietat, i els valors són cadenes on fer la cerca. Si no es donen opcions addicionals, farà una cerca de tipus `LIKE  "%...%"`.<br><br>Admet les propietats: `name`, `description`.<br><br>El directori d'usuari del tipus SAML tindrà un lloc buit valor tant per als camps `name` com per a `description`. Tots dos camps es poden canviar amb l'operació `userdirectory.update`.| |countOutput|boolean|Aquests paràmetres que són comuns per a tots els mètodes `get` es descriuen en detall al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |valuemapids|ID/array|Return only value maps with the given IDs.| |selectMappings|query|Return the value mappings for current value map in the [`mappings`](/manual/api/reference/valuemap/object#value_mappings) property.<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `valuemapid`, `name`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres definint la sortida esperada.  Aquest mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |valuemapids|ID/array|Retorna només taules de mapes de valors amb els identificadors donats.| |selectMappings|query|Retorna les coincidències de valors actuals a la propietat [`mappings`](/manual/api/reference/valuemap/object#value_mappings).<br><br>Admet `count`.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `valuemapid`, `name`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the LLD rules to copy and the target hosts.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryids|array|IDs of the [LLD rules](/manual/api/reference/discoveryrule/object#lld-rule) to be copied.| |hostids|array|IDs of the [hosts](/manual/api/reference/host/object#host) to copy the LLD rules to.|
ca	### Paràmetres  `(object)` Paràmetres definint les regles de descoberta LLD que s'han de copiar i els equips destinataris.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |discoveryids|array|IDs de les [regles LLD](/manual/api/reference/discoveryrule/object#lld-rule) que s'han de copiar.| |hostids|array|IDs dels [equips](/manual/api/reference/host/object#host) on hem de copiar les regles LLD.|

en-us	### Parameters  `(object)` Parameters defining the objects to be exported and the format to use.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |format|string|Format in which the data must be exported.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - unprocessed PHP array.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |prettyprint|boolean|Make the output more human readable by adding indentation.<br><br>Possible values:<br>`true` - add indentation;<br>`false` - *(default)* do not add indentation.| |options|object|Objects to be exported.<br><br>The `options` object has the following parameters:<br>`host_groups` - `(array)` IDs of host groups to export;<br>`hosts` - `(array)` IDs of hosts to export;<br>`images` - `(array)` IDs of images to export;<br>`maps` - `(array)` IDs of maps to export;<br>`mediaTypes` - `(array)` IDs of media types to export;<br>`template_groups` - `(array)` IDs of template groups to export;<br>`templates` - `(array)` IDs of templates to export.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que defineixen els objectes a exportar i el format a emprar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |format|cadena|Format en que la informació serà exportada.<br><br>Valors possibles:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON;<br>`raw` - taula PHP no processada.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |prettyprint|boolean|Fer que la sortida sigui més entenedora per les persones, afegint-t'hi sagnat.<br><br>Valors possibles:<br>`true` - afegir sagnat;<br>`false` - *(per defecte)* no afegir sagnat.| |options|objecte|Objectes a exportar.<br><br>L'objecte `options` té els paràmetres següents:<br>`host_groups` - `(array)` IDs dels grups d'equips a exportar;<br>`hosts` - `(array)` IDs dels equips a exportar;<br>`images` - `(array)` IDs de les imatges a exportar;<br>`maps` - `(array)` IDs dels mapes a exportar;<br>`mediaTypes` - `(array)` IDs dels tipus de medis a exportar;<br>`template_groups` - `(array)` IDs dels grups de plantilles a exportar<br>`templates`-`(array)` IDs de les plantilles a exportar.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` [Settings properties](object#settings) to be updated.
ca	### Paràmetres  `(object)` [Propietats de configuració](object#settings) que s'actualitzaran.

en-us	### Parameters  `(object)` User directory properties.  Since `userdirectory.get` API does not return `bind_password` field, `userdirectoryid` and/or `bind_password` should be supplied.\ Additionally to the [standard user directory properties](object#userdirectory), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |test_username|string|Username to test in user directory.| |test_password|string|Username associated password to test in user directory.|
ca	### Paràmetres  `(objecte)` Propietats del directori d'usuari.  Com que l'API `userdirectory.get` no retorna el camp `bind_password`, s'haurien de proporcionar `userdirectoryid` i/o `bind_password`.\ A més de les [propietats del directori d'usuari estàndard] (objecte#directori d'usuari), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |test_username|cadena|Nom d'usuari per provar al directori d'usuaris.| |test_password|cadena|Mot de pas associat al nom d'usuari per provar al directori d'usuaris.|

en-us	#### Parameters  |Parameter|Description|Defaults|Example| |--|------|--|---| |*endpoint*|Protocol and address of the endpoint, defined as `protocol://connection_string`<br><br>Possible protocol values: *rtu*, *ascii* (Agent 2 only), *tcp*<br><br>Connection string format:<br><br>with *tcp* - `address:port`<br>with serial line: *rtu*, *ascii* - `port_name:speed:params`<br>where<br>'speed' - 1200, 9600 etc<br>'params' - data bits (5,6,7 or 8), parity (n,e or o for none/even/odd), stop bits (1 or 2)|protocol: none<br><br>*rtu/ascii* protocol:<br>port\_name: none<br>speed: 115200<br>params: 8n1<br><br>*tcp* protocol:<br>address: none<br>port: 502|tcp://192.168.6.1:511<br>tcp://192.168.6.2<br>tcp://\[::1\]:511<br>tcp://::1<br>tcp://localhost:511<br>tcp://localhost<br>rtu://COM1:9600:8n<br>ascii://COM2:1200:7o2<br>rtu://ttyS0:9600<br>ascii://ttyS1| |*slave id*|Modbus address of the device it is intended for (1 to 247), see [MODBUS Messaging Implementation Guide](https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf) (page 23)<br><br>tcp device (not GW) will ignore the field|serial: 1<br><br>tcp: 255 (0xFF)|2| |*function*|Empty or value of a supported function:<br><br>1 - Read Coil,<br>2 - Read Discrete Input,<br>3 - Read Holding Registers,<br>4 - Read Input Registers|empty|3| |*address*|Address of the first registry, coil or input.<br><br>If 'function' is empty, then 'address' should be in range for:<br>Coil - 00001 - 09999<br>Discrete input - 10001 - 19999<br>Input register - 30001 - 39999<br>Holding register - 40001 - 49999<br><br>If 'function' is not empty, the 'address' field will be from 0 till 65535 and used without modification (PDU)|empty function: 00001<br><br>non-empty function: 0|9999| |*count*|Count of sequenced 'type' which will be read from device, where:<br><br>for Coil or Discrete input the 'type' = 1 bit<br>for other cases: (count\*type)/2 = real count of registers for reading<br>If 'offset' is not 0, the value will be added to 'real count'<br>Acceptable range for 'real count' is 1:65535|1|2| |*type*|Data type:<br><br>for Read Coil and Read Discrete Input - *bit*<br><br>for Read Holding Registers and Read Input Registers:<br>*int8* - 8bit<br>*uint8* - 8bit (unsigned)<br>*int16* - 16bit<br>*uint16* - 16bit (unsigned)<br>*int32* - 32bit<br>*uint32* - 32bit (unsigned)<br>*float* - 32bit<br>*uint64* - 64bit (unsigned)<br>*double* - 64bit|bit<br>uint16|uint64| |*endianness*|Endianness type:<br>*be* - Big Endian<br>*le* - Little Endian<br>*mbe* - Mid-Big Endian<br>*mle* - Mid-Little Endian<br><br>Limitations:<br>for 1 bit - be<br>for 8 bits - be,le<br>for 16 bits - be,le|be|le| |*offset*|Number of registers, starting from 'address', the result of which will be discarded.<br><br>The size of each register is 16bit (needed to support equipment that does not support random read access).|0|4|
ca	#### Paràmetres  |Paràmetre|Descripció|Per defecte|Exemple| |--|------|--|---| |*endpoint*|Protocol i adreça del terminal, definits com a `protocol://connection_string`<br><br>Valors possibles del protocol: *rtu*, *ascii* (només Agent 2), *tcp*<br><br>Format de la cadena de connexió:<br><br>avec *tcp* - `address:port`<br>amb línia sèrie: *rtu*, *ascii* - `port_name:speed:params`<br>où<br>'speed' - 1200, 9600 etc<br>'params' - bits de dades (5,6,7 ou 8), paritat (n/e/o per a cap/parell/senar - none/even/odd), bits d'aturada (1 ou 2)|protocol : cap<br><br>*rtu/ascii* protocol:<br>port\_name: cap<br>speed: 115200<br>params: 8n1<br><br>*tcp* protocol:<br>address: cap<br>port: 502|tcp://192.168.6.1:511<br>tcp://192.168.6.2<br>tcp://\[::1\]:511<br>tcp://::1<br>tcp://localhost:511<br>tcp://localhost<br>rtu://COM1:9600:8n<br>ascii://COM2:1200:7o2<br>rtu://ttyS0:9600<br>ascii://ttyS1| |*slave id*|Adreça Modbus de l'equip destinatari (1 à 247), veieu [MODBUS Messaging Implementation Guide](https://modbus.org/docs/Modbus_Messaging_Implementation_Guide_V1_0b.pdf) (page 23)<br><br>el perifèric tcp (no pas GW) ignorarà el camp|serial: 1<br><br>tcp: 255 (0xFF)|2| |*function*|Buida o valor d'una funció suportada:<br><br>1 - Read Coil,<br>2 - Read Discrete Input,<br>3 - Read Holding Registers,<br>4 - Read Input Registers|buida|3| |*address*|Adreça del primer registre, bobina o entrada.<br><br>Si 'function' és buit, llavors 'address' haurà d'ésser entre:<br>Coil - 00001 - 09999<br>Discrete input - 10001 - 19999<br>Input register - 30001 - 39999<br>Holding register - 40001 - 49999<br><br>Si 'function' no és pas buit, el camp 'address' serà de 0 a 65535 i emprat sense modificació (PDU)|funció buida: 00001<br><br>funció no buida: 0|9999| |*count*|Nombre de 'types' de seqüència que es llegiran a partir de l'aparell, on:<br><br>per Coil o Discrete input el 'type' = 1 bit<br>per la resta de casos: (count\*type)/2 = nombre real de registres per llegir<br>Si 'offset' no és pas 0, el valor s'afegirà a 'real count'<br>El rang acceptable per 'real count' és 1:65535|1|2| |*type*|Tipus de dades:<br><br>per Read Coil i Read Discrete Input - *bit*<br><br>per Read Holding Registers i Read Input Registers:<br>*int8* - 8bit<br>*uint8* - 8bit (no signat)<br>*int16* - 16bit<br>*uint16* - 16bit (no signat)<br>*int32* - 32bit<br>*uint32* - 32bit (no signat)<br>*float* - 32bit<br>*uint64* - 64bit (no signat)<br>*double* - 64bit|bit<br>uint16|uint64| |*endianness*|Tipus d'endianitat:<br>*be* - Big Endian<br>*le* - Little Endian<br>*mbe* - Mid-Big Endian<br>*mle* - Mid-Little Endian<br><br>Limitacions:<br>per 1 bit - be<br>per 8 bits - be,le<br>per 16 bits - be,le|be|le| |*offset*|Nombre de registres, a partir de 'address', on s'ignorarà el resultat.<br><br>La mida de cada registre és de 16 bits (necessari per suportar equipament que no suporten pas la lectura aleatòria).|0|4|

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Ceph.Default.ApiKey|no| | |Default API key for connecting to Ceph; used if no value is specified in an item key or named session.| |Plugins.Ceph.Default.User|no| | |Default username for connecting to Ceph; used if no value is specified in an item key or named session.| |Plugins.Ceph.Default.Uri|no| |https://localhost:8003 |Default URI for connecting to Ceph; used if no value is specified in an item key or named session. <br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `https` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=8003).<br>Examples: `https://127.0.0.1:8003`<br>`localhost`| |Plugins.Ceph.InsecureSkipVerify|no|false / true|false|Determines whether an http client should verify the server's certificate chain and host name.<br>If *true*, TLS accepts any certificate presented by the server and any host name in that certificate. In this mode, TLS is susceptible to man-in-the-middle attacks (should be used only for testing).| |Plugins.Ceph.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Ceph.Sessions.<SessionName>.ApiKey|no| | |Named session API key.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Ceph.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Ceph.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `https` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=8003).<br>Examples: `https://127.0.0.1:8003`<br>`localhost`| |Plugins.Ceph.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Per defecte|Descripció| |--|--|--|--|----------| |Plugins.Ceph.Default.ApiKey|no| | |Clau API predeterminada per connectar-se a Ceph; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Ceph.Default.User|no| | |Nom d'usuari per defecte per connectar-se a Ceph; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Ceph.Default.Uri|no| |https://localhost:8003 |URI per defecte per connectar-se a Ceph; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom. <br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Només s'admet l'esquema `https`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=8003).<br>Exemples: `https://127.0.0.1:8003`<br>`localhost`| |Plugins.Ceph.InsecureSkipVerify|no|false / true|false|Determina si un client http ha de verificar la cadena de certificats i el nom d'equip del servidor.<br>Si *true*, TLS accepta tot certificat presentat per el servidor i tot nom d'equip dins el certificat. En aquest mode, TLS és sensible als atacs man-in-the-middle (per tant, s'ha d'emprar només per entorns de proves).| |Plugins.Ceph.KeepAlive|no|60-900|300|El temps màxim d'espera (en segons) abans es tanquin les connexions de plug-in que no s'empren.| |Plugins.Ceph.Sessions.<SessionName>.ApiKey|no|<|<|Clau de l'api de sessió anomenada.<br>**<SessionName>** - nom d'una sessió a emprar dins les claus d'element.| |Plugins.Ceph.Sessions.<SessionName>.User|no|<|<|Nom d'usuari de la sessió anomenada.<br>**<SessionName>** - nom d'una sessió a emprar dins les claus d'element.| |Plugins.Ceph.Sessions.<SessionName>.Uri|no|<|https://localhost:8003|Cadena de connexió d'una sessió anomenada.<br>**<SessionName>** - nom d'una sessió a emprar dins les claus d'element.<br><br>No hauria d'incloure les informacions d'identificació integrades (aquestes seran ignorades).<br>Ha de correspondre al format URI.<br>Només l'esquema `https` és admès; un esquema es pot ometre.<br>Es pot ometre un port (per defecte=8003).<br>Exemples: `https://127.0.0.1:8003`<br>`localhost`| |Plugins.Ceph.Timeout|no|1-30|global timeout|Temps d'espera d'execució de la petició (quan de temps ha d'esperar per una comanda abans de tancar-la).|  Veieu també:  -   Descripció dels paràmetres de configuració generals de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instruccions per configurar els [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Docker.Endpoint|no| |unix:///var/run/docker.sock|Docker daemon unix-socket location.<br>Must contain a scheme (only `unix://` is supported).| |Plugins.Docker.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Per defecte|Descripció| |--|--|--|--|----------| |Plugins.Docker.Endpoint|no| |unix:///var/run/docker.sock|Ubicació del socket unix del dimoni Docker.<br>Ha de contindre un esquema (només s'admet `unix://`).| |Plugins.Docker.Timeout|no|1-30|global timeout|Espera d'execució de la petició (quan de temps ha d'esperar que una petició acabi abans de tancar).|  Veieu també:  -   Descripció dels paràmetres generals de configuració de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instruccions per la configuració dels [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.EmberPlus.Default.Uri|no| |tcp://localhost:9998|The default URI to connect. The only supported schema is `tcp://`. A schema can be omitted. Embedded credentials will be ignored.| |Plugins.EmberPlus.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.EmberPlus.Sessions.<SessionName>.Uri|no| |tcp://localhost:9998|The URI to connect, for the named session. The only supported schema is `tcp://`. A schema can be omitted. Embedded credentials will be ignored.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.EmberPlus.System.Path|no| | |Path to the Ember+ plugin executable.<br>Example usage: `Plugins.EmberPlus.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-ember`| |Plugins.EmberPlus.Timeout|no|1-30|global timeout|The amount of time to wait for a server to respond when first connecting and on follow-up operations in the session.|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Predeterminat|Descripció| |--|--|--|--|-----------| |Plugins.EmberPlus.Default.Uri|no| |tcp://localhost:9998|L'URI predeterminat per connectar-se. L'únic esquema compatible és `tcp://`. Es pot ometre un esquema. Les credencials incrustades seran ignorades.| |Plugins.EmberPlus.KeepAlive|no|60-900|300|El temps màxim d'espera (en segons) abans que es tanquin les connexions de connectors no emprats.| |Plugins.EmberPlus.Sessions.<SessionName>.Uri|no| |tcp://localhost:9998|L'URI per connectar, per a la sessió anomenada. L'únic esquema compatible és `tcp://`. Es pot ometre un esquema. Les credencials incrustades s'ignoraran.<br>**<NomSessió>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.EmberPlus.System.Path|no| | |Camí a l'executable del connector Ember+.<br>Exemple d'ús: `Plugins.EmberPlus.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-ember`| |Plugins.EmberPlus.Timeout|no|1-30|temps d'espera global|La quantitat de temps d'espera que un servidor respongui quan es connecta per primer cop i a les operacions de seguiment de la sessió.|  Veieu també:  - Descripció dels paràmetres de configuració generals de l'agent 2 de Zabbix:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Agent Zabbix 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) - Instruccions per configurar [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Memcached.Default.Password|no| | |Default password for connecting to Memcached; used if no value is specified in an item key or named session.| |Plugins.Memcached.Default.Uri|no| |tcp://localhost:11211|Default URI for connecting to Memcached; used if no value is specified in an item key or named session. <br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted.<br>A port can be omitted (default=11211).<br>Examples: `tcp://localhost:11211`<br>`localhost`<br>`unix:/var/run/memcached.sock`| |Plugins.Memcached.Default.User|no| | |Default username for connecting to Memcached; used if no value is specified in an item key or named session.| |Plugins.Memcached.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Memcached.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Memcached.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted.<br>A port can be omitted (default=11211).<br>Examples: `tcp://localhost:11211`<br>`localhost`<br>`unix:/var/run/memcached.sock`| |Plugins.Memcached.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Memcached.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Per defecte|Descripció| |--|--|--|--|----------| |Plugins.Memcached.Default.Password|no| | |Mot de pas per defecte per connectar-se a Memcached; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Memcached.Default.Uri|no| |tcp://localhost:11211|URI per defecte per connectar-se a Memcached; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom. <br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=11211).<br>Exemples: `tcp://localhost:11211`<br>`localhost`<br>`unix:/var/run /memcached.sock`| |Plugins.Memcached.Default.User|no| | |Nom d'usuari per defecte per connectar-se a Memcached; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Memcached.KeepAlive|no|60-900|300|El temps d'espera màxim (en segons) abans que les connexions no emprades dels plugins es tanquin.| |Plugins.Memcached.Sessions.<SessionName>.Password|no|<|<|Paraula de pas de la sessió anomenada.<br>**<SessionName>** - nom d'una sessió a emprar dins les claus d'element.| |Plugins.Memcached.Sessions.<SessionName>.Uri|no|<|tcp://localhost:11211|Cadena de connexió d'una sessió donada.<br>**<SessionName>** - nom d'una sessió a emprar dins les claus d'element.<br><br>No ha d'incloure pas les informacions d'identificació integrades (aquestes s'ignoraran).<br>Ha de correspondre al format URI.<br>Esquemes admesos: `tcp`, `unix`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=11211).<br>Exemples: `tcp://localhost:11211`<br>`localhost`<br>`unix:/var/run/memcached.sock`| |Plugins.Memcached.Sessions.<SessionName>.User|no|<|<|Usuari de la sessió esmentada.<br>**<SessionName>** - nom d'una sessió a emprar dins les claus d'element.| |Plugins.Memcached.Timeout|no|1-30|global timeout|Temps d'espera d'execució de la demanda (quan de temps ha d'esperar que una comanda acabi abans de tancar-la).|  Veieu també:  -   Descripció general dels paràmetres de configuració de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instruccions per configurar els [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Modbus.Sessions.<SessionName>.Endpoint|no| | |Endpoint is a connection string consisting of a protocol scheme, a host address and a port or serial port name and attributes.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Modbus.Sessions.<SessionName>.SlaveID|no| | |Slave ID of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br>Example: `Plugins.Modbus.Sessions.MB1.SlaveID=20`<br>*Note* that this named session parameter is checked only if the value provided in the [item key](/manual/config/items/itemtypes/zabbix_agent) slave ID parameter is empty.| |Plugins.Modbus.Sessions.<SessionName>.Timeout|no| | |Timeout of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br>Example: `Plugins.Modbus.Sessions.MB1.Timeout=2`|  If you need to set the request execution timeout (how long to wait for a request to complete before shutting it down), use the [item configuration](/manual/config/items/item#configuration) form.  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Per defecte|Descripció| |--|--|--|--|----------| |Plugins.Modbus.Sessions.<SessionName>.Endpoint|no|<|<|Endpoint és una cadena de connexió consistent en un sistema de protocol, una adreça d'equip i un port o nom de port sèrie i d'atributs.<br>**<SessionName>** - definit el nom d'una sessió a emprar dins les claus d'elements.| |Plugins.Modbus.Sessions.<SessionName>.SlaveID|no|<|<|Esclau d'una sessió donada.<br>**<SessionName>** - definit el nom d'una sessió a emprar dins les claus d'element.<br>Exemple: `Plugins.Modbus.Sessions.MB1.SlaveID=20`<br>*Veieu* que aquest paràmetre de sessió donat no ha pas verificat que si el valor proporcionat dins el paràmetre de l'ID d'esclau de la clau [clau de l'element](/manual/config/items/itemtypes/zabbix_agent) és buit.| |Plugins.Modbus.Sessions.<SessionName>.Timeout|no|<|<|Temps d'espera de la sessió donada.<br>**<SessionName>** - defineix el nom d'una sessió a emprar dins les claus d'element.<br>Exemple: `Plugins.Modbus.Sessions.MB1.Timeout=2`|  Si us cal establir el timeout d'execució de la comanda (quan de temps hem de romandre esperant una petició per enllestir-la abans d'apagar), empreu el formulari de [configuració d'element](/manual/config/items/item#configuration).  Veieu també:  -   Descripció general dels paràmetres de configuració de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instruccions per configurar els [plugins](/manual/extensions/plugins)

en-us	 #### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.MongoDB.Default.Password|no| | |Default password for connecting to MongoDB; used if no value is specified in an item key or named session.| |Plugins.MongoDB.Default.Uri|no| | |Default URI for connecting to MongoDB; used if no value is specified in an item key or named session. <br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=27017).<br>Examples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`| |Plugins.MongoDB.Default.User|no| | |Default username for connecting to MongoDB; used if no value is specified in an item key or named session.| |Plugins.MongoDB.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.MongoDB.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile|no <br>(yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to one of: verify_ca, verify_full)| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys. | |Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile|yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile is specified| | |Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys. | |Plugins.MongoDB.Sessions.<SessionName>.TLSConnect|no | | |Encryption type for communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Supported values:<br>*required* - require TLS connection;<br>*verify\_ca* - verify certificates;<br>*verify\_full* - verify certificates and IP address. <br><br> Supported since plugin version 1.2.1| |Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile|yes, if Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile is specified| | |Full pathname of a file containing the database private key used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys. | |Plugins.MongoDB.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=27017).<br>Examples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`| |Plugins.MongoDB.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MongoDB.System.Path|no| | |Path to plugin executable.| |Plugins.MongoDB.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres   |Paràmetre|Obligatori|Interval|Per defecte|Descripció| |--|--|--|--|-----------| |Plugins.MongoDB.Default.Password|no| | |Mot de pas per defecte per connectar-se a MongoDB; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.MongoDB.Default.Uri|no| | |URI per defecte per connectar-se a MongoDB; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom. <br><br>No han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Només s'admet l'esquema `tcp`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=27017).<br>Exemples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`| |Plugins.MongoDB.Default.User|no| | |Nom d'usuari per defecte per connectar-se a MongoDB; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.MongoDB.KeepAlive|no|60-900|300|Temps d'espera màxim (en segons) abans que es tanquin les connexions de connectors no emprats.| |Plugins.Mongo.Sessions.<SessionName>.Password|no| | |Mot de pas de la sessió anomenada.<br>**<SessionName>** - nom d'una sessió que s'emprarà a les claus d'elements.| |Plugins.MongoDB.Sessions.<SessionName>.TLSCAFile|no <br>(sí, si Plugins.MongoDB.Sessions.<SessionName>.TLSConnect és establert a un dels següents: verify_ca, verify_full)| | |Nom de camí complet d'un fitxer que conté certificats de CA de nivell superior per a la verificació de certificats d'iguals, emprat per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<SessionName>** - defineix el nom d'una sessió que s'emprarà a l'element clau.| |Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile|sí, si Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile s'ha definit| | |Camí complet d'un fitxer que conté el certificat de l'agent o la cadena de certificats, emprat per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<SessionName>** - defineix el nom d'una sessió que s'emprarà a les claus d'element.| |Plugins.MongoDB.Sessions.<SessionName>.TLSConnect|no | | |Tipus de xifrat de les comunicacions entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<SessionName>** - defineix el nom d'una sessió que s'emprarà a les claus d'element.<br> <br>Valors acceptats:<br>*required* - requereix connexió TLS;<br>*verify\_ca* - verifica els certificats;<br>*verify\_full* - verifica els certificats i l'adreça IP. <br><br> Admès des de la versió 1.2.1 del plugin| |Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile|sí, si Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile era establert| | |Camí complet d'un fitxer que conté la clau privada de la base de dades que s'empra per a les comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<SessionName>** - defineix el nom d'una sessió que s'emprarà a les claus d'element.| |Plugins.MongoDB.Sessions.<SessionName>.Uri|no| | |Cadena de connexió d'una sessió anomenada.<br>**<Nom de la sessió>**: nom d'una sessió que s'emprarà a les claus d'element.<br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br> Ha de coincidir amb el format URI.<br>Només s'admet l'esquema `tcp`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=27017).<br>Exemples: `tcp://127.0.0.1:27017`, `tcp:localhost`, `localhost`| |Plugins.MongoDB.Sessions.<Nom de sessió>.Usuari|no| | |Nom d'usuari de la sessió.<br>**<Nom de la sessió>** - nom d'una sessió que s'emprarà a les claus d'elements.| |Plugins.MongoDB.System.Path|no| | |Camí a l'executable del connector extern.| |Plugins.MongoDB.Timeout|no|1-30|timeout global|Temps d'espera d'execució de la petició (quant de temps cal esperar que acabi una petició abans d'aturar-la).|  Veieu també:   - Descripció de la configuració general de l'agent Zabbix 2:      [Agent Zabbix 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /      [Agent Zabbix 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) - Instruccions de configuració per a [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.MQTT.Default.Password|no| | |Default password for connecting to MQTT; used if no value is specified in an item key or named session.| |Plugins.MQTT.Default.TLSCAFile|no| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification for encrypted communications between Zabbix agent 2 and MQTT broker; used if no value is specified in a named session.| |Plugins.MQTT.Default.TLSCertFile|no| | |Full pathname of a file containing the agent certificate or certificate chain for encrypted communications between Zabbix agent 2 and MQTT broker; used if no value is specified in a named session.| |Plugins.MQTT.Default.TLSKeyFile|no| | |Full pathname of a file containing the MQTT private key for encrypted communications between Zabbix agent 2 and MQTT broker; used if no value is specified in a named session.| |Plugins.MQTT.Default.Topic|no| | |Default topic for MQTT subscription; used if no value is specified in an item key or named session.<br><br>The topic may contain wildcards ("+","#")<br>Examples: `path/to/file`<br>`path/to/#`<br>`path/+/topic`| |Plugins.MQTT.Default.Url|no| |tcp://localhost:1883|Default MQTT broker connection string; used if no value is specified in an item key or named session.<br><br>Should not include query parameters.<br>Must match the URL format.<br>Supported schemes: `tcp` (default), `ws`, `tls`; a scheme can be omitted.<br>A port can be omitted (default=1883).<br>Examples: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`| |Plugins.MQTT.Default.User|no| | |Default username for connecting to MQTT; used if no value is specified in an item key or named session.| |Plugins.MQTT.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MQTT.Sessions.<SessionName>.TLSCAFile|no| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and MQTT broker.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MQTT.Sessions.<SessionName>.TLSCertFile|no| | |Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and MQTT broker.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile|no| | |Full pathname of a file containing the MQTT private key used for encrypted communications between Zabbix agent 2 and MQTT broker.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MQTT.Sessions.<SessionName>.Topic|no| | |Named session topic for MQTT subscription.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>The topic may contain wildcards ("+","#")<br>Examples: `path/to/file`<br>`path/to/#`<br>`path/+/topic`| |Plugins.MQTT.Sessions.<SessionName>.Url|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include query parameters.<br>Must match the URL format.<br>Supported schemes: `tcp` (default), `ws`, `tls`; a scheme can be omitted.<br>A port can be omitted (default=1883).<br>Examples: `tcp://host:1883`<br>`localhost`<br>`ws://host:8080`| |Plugins.MQTT.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.|  If you need to set the request execution timeout (how long to wait for a request to complete before shutting it down), use the [item configuration](/manual/config/items/item#configuration) form.  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Per defecte|Descripció| |--|--|--|--|----------| |Plugins.MQTT.Default.Password|no| | |Mot de pas per defecte per connectar-se a MQTT; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.| |Plugins.MQTT.Default.TLSCAFile|no| | |Camí d'accés complet d'un fitxer que conté els certificats de CA(s) de nivell superior per a la verificació de certificats d'iguals per a comunicacions xifrades entre l'agent Zabbix 2 i l'agent MQTT; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.MQTT.Default.TLSCertFile|no| | |Camí d'accés complet d'un fitxer que conté el certificat de l'agent o la cadena de certificats per a comunicacions xifrades entre l'agent Zabbix 2 i l'agent MQTT; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.MQTT.Default.TLSKeyFile|no| | |Camí complet d'un fitxer que conté la clau privada MQTT per a comunicacions xifrades entre l'agent Zabbix 2 i l'agent MQTT; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.MQTT.Default.Topic|no| | |Tema per defecte per a la subscripció a MQTT; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.<br><br>El tema pot contindre comodins ("+","#")<br>Exemples: `camí/a/fitxer`<br>` path/to/#`<br>`path/+/topic`| |Plugins.MQTT.Default.Url|no| |tcp://localhost:1883|Cadena de connexió de l'agent MQTT predeterminat; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.<br><br>No ha d'incloure paràmetres de consulta.<br>Ha de coincidir amb el format d'URL.<br>Esquemes admesos: `tcp` (predeterminat), `ws `, `tls`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=1883).<br>Exemples: `tcp://host:1883`<br>`localhost`<br>`ws://host: 8080`| |Plugins.MQTT.Default.User|no| | |Nom d'usuari per defecte per connectar-se a MQTT; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.| |Plugins.MQTT.Sessions.<Nom de la sessió>.Password|no| | |Mot de pas de sessió anomenada.<br>**<Nom de sessió>** - defineix el nom d'una sessió per emprar-la a les claus d'element.| |Plugins.MQTT.Sessions.<SessionName>.TLSCAFile|no| | |Camí d'accés complet d'un fitxer que conté els certificats de CA de nivell superior per a la verificació de certificats d'igual, emprat per a comunicacions xifrades entre l'agent Zabbix 2 i l'agent MQTT.<br>**<Nom de sessió>** - defineix el nom d'una sessió per a emprant les claus d'elements.| |Plugins.MQTT.Sessions.<SessionName>.TLSCertFile|no| | |Camí d'accés complet d'un fitxer que conté el certificat de l'agent o la cadena de certificats, emprat per a comunicacions xifrades entre l'agent Zabbix 2 i l'agent MQTT.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.| |Plugins.MQTT.Sessions.<SessionName>.TLSKeyFile|no| | |Camí complet d'un fitxer que conté la clau privada MQTT que s'empra per a les comunicacions xifrades entre l'agent Zabbix 2 i l'agent MQTT.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.| |Plugins.MQTT.Sessions.<Nom de la sessió>.Tema|no| | |Tema de sessió amb nom per a la subscripció a MQTT.<br>**<Nom de la sessió>**: defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>El tema pot contenir comodins ("+","#") <br>Exemples: `path/to/file`<br>`path/to/#`<br>`path/+/topic`| |Plugins.MQTT.Sessions.<SessionName>.Url|no| | |Cadena de connexió d'una sessió amb nom.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>No hauria d'incloure paràmetres de consulta.<br>Ha de coincidir amb el format de l'URL.<br>Esquemes admesos: `tcp` (per defecte), `ws`, `tls`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=1883).<br>Exemples: `tcp://host:1883`<br>`localhost`<br>`ws://host: 8080`| |Plugins.MQTT.Sessions.<Nom de la sessió>.Usuari|no| | |Nom d'usuari de sessió amb nom.<br>**<Nom de sessió>** - defineix el nom d'una sessió per emprar-la a les claus d'element.|  Si us cal establir el timeout d'execució de la comanda (quan de temps hem de romandre esperant una petició per enllestir-la abans d'apagar), empreu el formulari de [configuració d'element](/manual/config/items/item#configuration).  Veieu també:  -   Descripció dels paràmetres generals de configuració de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instruccions per la configuració dels [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.MSSQL.CustomQueriesDir|no| |empty|Specifies the file path to a directory containing user-defined .sql files with custom queries that the plugin can execute. The plugin loads all available .sql files in the configured directory at startup. This means that any changes to the custom query files will not be reflected until the plugin is restarted. The plugin is started and stopped together with Zabbix agent 2.| |Plugins.MSSQL.Default.CACertPath|no| | |The default file path to the public key certificate of the certificate authority (CA) that issued the certificate of the MSSQL server. The certificate must be in PEM format.| |Plugins.MSSQL.Default.Database|no| | |The default database name to connect to.| |Plugins.MSSQL.Default.Encrypt|no| | |Specifies the default connection encryption type. Possible values are:<br>*true* - data sending between plugin and server is encrypted;<br>*false* - data sending between plugin and server is not encrypted beyond the login packet;<br>*strict* - data sending between plugin and server is encrypted E2E using [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);<br>*disable* - data sending between plugin and server is not encrypted.| |Plugins.MSSQL.Default.HostNameInCertificate|no| | |The common name (CN) of the certificate of the MSSQL server by default.| |Plugins.MSSQL.Default.Password|no| | |The password to be sent to a protected MSSQL server by default.| |Plugins.MSSQL.Default.TLSMinVersion|no| | |The minimum TLS version to use by default. Possible values are: `1.0`, `1.1`, `1.2`, `1.3`.| |Plugins.MSSQL.Default.TrustServerCertificate|no| | |Whether the plugin should trust the server certificate without validating it by default. Possible values: `true`, `false`.| |Plugins.MSSQL.Default.Uri|no| |sqlserver://localhost:1433|The default URI to connect. The only supported schema is `sqlserver://`. A schema can be omitted. Embedded credentials will be ignored.| |Plugins.MSSQL.Default.User|no| | |The default username to be sent to a protected MSSQL server.| |Plugins.MSSQL.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.MSSQL.Sessions.<SessionName>.CACertPath|no| | |The file path to the public key certificate of the certificate authority (CA) that issued the certificate of the MSSQL server for the named session. The certificate must be in PEM format.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.Database|no| | |The database name to connect to for the named session.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.Encrypt|no| | |Specifies the connection encryption type for the named session. Possible values are:<br>*true* - data sending between plugin and server is encrypted;<br>*false* - data sending between plugin and server is not encrypted beyond the login packet;<br>*strict* - data sending between plugin and server is encrypted E2E using [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);<br>*disable* - data sending between plugin and server is not encrypted.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate|no| | |The common name (CN) of the certificate of the MSSQL server for the named session.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.Password|no| | |The password to be sent to a protected MSSQL server for the named session.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion|no| | |The minimum TLS version to use for the named session. Possible values are: `1.0`, `1.1`, `1.2`, `1.3`.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate|no| | |Whether the plugin should trust the server certificate without validating it for the named session. Possible values: `true`, `false`.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.Uri|no| |sqlserver://localhost:1433|The URI to connect, for the named session. The only supported schema is `sqlserver://`. A schema can be omitted. Embedded credentials will be ignored.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.Sessions.<SessionName>.User|no| | |The username to be sent to a protected MSSQL server for the named session.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.MSSQL.System.Path|no| | |Path to the MSSQL plugin executable.<br>Global setting for the MSSQL plugin. Applied to all connections.<br>Example usage: `Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql`| |Plugins.MSSQL.Timeout|no|1-30|global timeout|The amount of time to wait for a server to respond when first connecting and on follow-up operations in the session.|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Predeterminat|Descripció| |--|--|--|--|-----------| |Plugins.MSSQL.CustomQueriesDir|no| |buit|Especifica la ruta del fitxer a un directori que conté fitxers .sql definits per l'usuari amb consultes personalitzades que el plugin pot executar. El plugin carrega tots els fitxers .sql disponibles al directori configurat a l'inici. Això vol dir que els canvis als fitxers de consulta personalitzats no es reflectiran fins que es reiniciï el plugin. El plugin s'inicia i s'atura juntament amb l'agent Zabbix 2.| |Plugins.MSSQL.Default.CACertPath|no| | |Camí del fitxer predeterminada al certificat de clau pública de l'autoritat de certificació (CA) que va emetre el certificat del servidor MSSQL. El certificat ha de ser en format PEM.| |Plugins.MSSQL.Base de dades predeterminada|no| | |Nom de la base de dades per defecte a la que connectar-hi.| |Plugins.MSSQL.Default.Encrypt|no| | |Especifica el tipus de xifrat de connexió predeterminat. Els valors possibles són:<br>*true* - l'enviament de dades entre el plugin i el servidor està xifrat;<br>*false* - l'enviament de dades entre el plugin i el servidor no està xifrat més enllà del paquet d'inici de sessió;<br>*strict* - l'enviament de dades entre el plugin i el servidor es xifra E2E mitjançant [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);< br>*disable* - l'enviament de dades entre el plugin i el servidor no és pas xifrat.| |Plugins.MSSQL.Default.HostNameInCertificate|no| | |Nom comú (CN) del certificat del servidor MSSQL per defecte.| |Complements.MSSQL.DefaultPassword|no| | |Mot de pas per defecte que s'ha d'enviar a un servidor MSSQL protegit.| |Plugins.MSSQL.Default.TLSMinVersion|no| | |Versió mínima de TLS que cal emprar per defecte. Els valors possibles són: `1.0`, `1.1`, `1.2`, `1.3`.| |Plugins.MSSQL.Default.TrustServerCertificate|no| | |Si el plugin hauria de confiar en el certificat del servidor sense validar-lo per defecte. Valors possibles: `true`, `false`.| |Plugins.MSSQL.Default.Uri|no| |sqlserver://localhost:1433|URI predeterminat on connectar. L'únic esquema compatible és `sqlserver://`. Es pot ometre un esquema. Les credencials incrustades seran ignorades.| |Plugins.MSSQL.Default.User|no| | |Nom d'usuari predeterminat que s'enviarà a un servidor MSSQL protegit.| |Plugins.MSSQL.KeepAlive|no|60-900|300|Temps màxim d'espera (en segons) abans que es tanquin les connexions de plugins no emprats.| |Plugins.MSSQL.Sessions.<SessionName>.CACertPath|no| | |Camí del fitxer al certificat de clau pública de l'autoritat de certificació (CA) que va emetre el certificat del servidor MSSQL per a la sessió anomenada. El certificat ha de ser en format PEM.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.Database|no| | |El nom de la base de dades on connectar per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.Encrypt|no| | |Especifica el tipus de xifrat de connexió per a la sessió anomenada. Els valors possibles són:<br>*true* - l'enviament de dades entre el plugin i el servidor és xifrat;<br>*false* - l'enviament de dades entre el plugin i el servidor no és pas xifrat més enllà del paquet d'inici de sessió;<br>*strict* - l'enviament de dades entre el plugin i el servidor es xifra E2E mitjançant [TDS8](https://learn.microsoft.com/en-us/sql/relational-databases/security/networking/tds-8?view=sql-server-ver16);<br>*disable* - l'enviament de dades entre el plugin i el servidor no és pas xifrat.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.HostNameInCertificate|no| | |El nom comú (CN) del certificat del servidor MSSQL per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la en claus d'element.| |Plugins.MSSQL.Sessions.<SessionName>.Mot de pas|no| | |Mot de pas que s'ha d'enviar a un servidor MSSQL protegit per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.TLSMinVersion|no| | |La versió mínima de TLS que cal emprar per a la sessió anomenada. Els valors possibles són: `1.0`, `1.1`, `1.2`, `1.3`.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.TrustServerCertificate|no| | |Si el plugin hauria de confiar en el certificat del servidor sense validar-lo per a la sessió anomenada. Valors possibles: `true`, `false`.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.Uri|no| |sqlserver://localhost:1433|URI per connectar, per a la sessió anomenada. L'únic esquema compatible és `sqlserver://`. Es pot ometre un esquema. Les credencials incrustades s'ignoraran.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.Sessions.<SessionName>.User|no| | |Nom d'usuari que s'ha d'enviar a un servidor MSSQL protegit per a la sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.MSSQL.System.Path|no| | |Camí de l'executable del plugin MSSQL.<br>Configuració global del plugin MSSQL. S'aplica a totes les connexions.<br>Exemple d'ús: `Plugins.MSSQL.System.Path=/usr/sbin/zabbix-agent2-plugin/zabbix-agent2-plugin-mssql`| |Plugins.MSSQL.Timeout|no|1-30|global timeout|La quantitat de temps d'espera que un servidor respongui quan es connecta per primera vegada i en les operacions de seguiment de la sessió.|  Veieu també:  - Descripció dels paràmetres de configuració generals de l'agent 2 de Zabbix:     [Agent Zabbix 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Agent Zabbix 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) - Instruccions per configurar [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Mysql.CallTimeout|no|1-30|global timeout|The maximum amount of time in seconds to wait for a request to be done.| |Plugins.Mysql.CustomQueriesPath|no| |empty|Full path to the directory used for storing custom queries.| |Plugins.Mysql.Default.Password|no| | |Default password for connecting to MySQL; used if no value is specified in an item key or named session.| |Plugins.Mysql.Default.TLSCAFile|no<br>(yes, if Plugins.Mysql.Default.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification for encrypted communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.| |Plugins.Mysql.Default.TLSCertFile|no<br>(yes, if Plugins.Mysql.Default.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the agent certificate or certificate chain for encrypted communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.| |Plugins.Mysql.Default.TLSConnect|no| | |Encryption type for communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.<br><br>Supported values:<br>*required* - require TLS connection;<br>*verify\_ca* - verify certificates;<br>*verify\_full* - verify certificates and IP address.| |Plugins.Mysql.Default.TLSKeyFile|no<br>(yes, if Plugins.Mysql.Default.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the database private key for encrypted communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.| |Plugins.Mysql.Default.Uri|no| |tcp://localhost:3306|Default URI for connecting to MySQL; used if no value is specified in an item key or named session. <br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted.<br>A port can be omitted (default=3306).<br>Examples: `tcp://localhost:3306`<br>`localhost`<br>`unix:/var/run/mysql.sock`| |Plugins.Mysql.Default.User|no| | |Default username for connecting to MySQL; used if no value is specified in an item key or named session.| |Plugins.Mysql.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Mysql.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Mysql.Sessions.<SessionName>.TLSCAFile|no<br>(yes, if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the top-level CA(s) certificates for peer certificate verification, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Mysql.Sessions.<SessionName>.TLSCertFile|yes, if Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile is specified| | |Full pathname of a file containing the agent certificate or certificate chain, used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Mysql.Sessions.<SessionName>.TLSConnect|no| | |Encryption type for communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Supported values:<br>*required* - require TLS connection;<br>*verify\_ca* - verify certificates;<br>*verify\_full* - verify certificates and IP address.| |Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile|yes, if Plugins.Mysql.Sessions.<SessionName>.TLSCertFile is specified| | |Full pathname of a file containing the database private key used for encrypted communications between Zabbix agent 2 and monitored databases.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Mysql.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted.<br>A port can be omitted (default=3306).<br>Examples: `tcp://localhost:3306`<br>`localhost`<br>`unix:/var/run/mysql.sock`| |Plugins.Mysql.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Mysql.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Predeterminat|Descripció| |--|--|--|--|-----------| |Plugins.Mysql.CallTimeout|no|1-30|temps d'espera global|La quantitat màxima de temps en segons per esperar que es faci una petició.| |Plugins.Mysql.CustomQueriesPath|no| |buit|Camí complet al directori emprat per emmagatzemar consultes personalitzades.| |Plugins.Mysql.Default.Password|no| | |Contrasenya per defecte per connectar-se a MySQL; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.| |Plugins.Mysql.Default.TLSCAFile|no<br>(sí, si Plugins.Mysql.Default.TLSConnect s'estableix en un dels següents: verify_ca, verify_full)| | |Camí complet d'un fitxer que conté els certificats de CA(s) de nivell superior per a la verificació de certificats d'iguals per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.Mysql.Default.TLSCertFile|no<br>(sí, si Plugins.Mysql.Default.TLSConnect s'estableix en un dels següents: `verify_ca`, `verify_full`)| | |Camí complet d'un fitxer que conté el certificat de l'agent o la cadena de certificats per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.Mysql.Default.TLSConnect|no| | |Tipus de xifratge per a les comunicacions entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.<br><br>Valors admesos:<br>*obligatori* - requereix connexió TLS;<br>*verify\_ca* - verificar els certificats;<br>*verify\_full * - verificar els certificats i l'adreça IP.| |Plugins.Mysql.Default.TLSKeyFile|no<br>(sí, si Plugins.Mysql.Default.TLSConnect s'estableix a *verify_ca* o *verify_full*)| | |Camí complet d'un fitxer que conté la clau privada de la base de dades per a les comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.Mysql.Default.Uri|no| |tcp://localhost:3306|URI per defecte per connectar-se a MySQL; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada. <br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=3306).<br>Exemples: `tcp://localhost:3306`<br>`localhost`<br>`unix:/var/run /mysql.sock`| |Plugins.Mysql.Default.User|no| | |Nom d'usuari per defecte per connectar-se a MySQL; s'empra si no s'especifica cap valor en una clau d'element o sessió anomenada.| |Plugins.Mysql.KeepAlive|no|60-900|300|El temps màxim d'espera (en segons) abans que es tanquin les connexions de connectors no emprats.| |Plugins.Mysql.Sessions.<SessionName>.Contrasenya|no| | |Contrasenya de sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.Mysql.Sessions.<SessionName>.TLSCAFile|no<br>(sí, si Plugins.Mysql.Sessions.<SessionName>.TLSConnect està establert en un dels següents: verifica_ca, verifica_complet)| | |Camí d'accés complet d'un fitxer que conté els certificats de CA(s) de nivell superior per a la verificació del certificat d'iguals, utilitzat per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<Nom de sessió>** - defineix el nom d'una sessió per a emprar en claus d'element.| |Plugins.Mysql.Sessions.<SessionName>.TLSCertFile|sí, si Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile és definit| | |Camí complet d'un fitxer que conté el certificat de l'agent o la cadena de certificats, utilitzat per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<NomSessió>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.Mysql.Sessions.<SessionName>.TLSConnect|no| | |Tipus de xifrat per a les comunicacions entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<NomSessió>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>Valors admesos:<br>*obligatori* - requereix una connexió TLS;<br>*verify\_ca* - verificar els certificats;<br>*verify\_full* - verificar els certificats i l'adreça IP.| |Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile|sí, si Plugins.Mysql.Sessions.<SessionName>.TLSCertFile és establert| | |Camí complet d'un fitxer que conté la clau privada de la base de dades que s'empra per a les comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la en claus d'elements.| |Plugins.Mysql.Sessions.<SessionName>.Uri|no| | |Cadena de connexió d'una sessió anomenada.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>No hauria d'incloure credencials incrustades (s'ignoraran).<br >Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=3306).<br>Exemples: `tcp://localhost:3306`<br>`localhost`<br>`unix:/var/run /mysql.sock`| |Plugins.Mysql.Sessions.<SessionName>.Usuari|no| | |Nom d'usuari de la sessió.<br>**<Nom de la sessió>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.Mysql.Timeout|no|1-30|temps d'espera global|Temps d'espera d'execució de la petició (quant de temps cal esperar que es completi una petició abans d'apagar-la).|  Veieu també:  - Descripció dels paràmetres de configuració generals de l'agent 2 de Zabbix:     [Agent Zabbix 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Agent Zabbix 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) - Instruccions per configurar [connectors](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Oracle.CallTimeout|no|1-30|global timeout|The maximum wait time in seconds for a request to be completed.| |Plugins.Oracle.ConnectTimeout|no|1-30|global timeout|The maximum wait time in seconds for a connection to be established.| |Plugins.Oracle.CustomQueriesPath|no| | |Full pathname of a directory containing .sql files with custom queries.<br>Disabled by default.<br>Example: `/etc/zabbix/oracle/sql`| |Plugins.Oracle.Default.Password|no| | |Default password for connecting to Oracle; used if no value is specified in an item key or named session.| |Plugins.Oracle.Default.Service|no| | |Default service name for connecting to Oracle (SID is not supported); used if no value is specified in an item key or named session.| |Plugins.Oracle.Default.Uri|no| |tcp://localhost:1521|Default URI for connecting to Oracle; used if no value is specified in an item key or named session.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=1521).<br>Examples: `tcp://127.0.0.1:1521`<br>`localhost`| |Plugins.Oracle.Default.User|no| | |Default username for connecting to Oracle; used if no value is specified in an item key or named session.| |Plugins.Oracle.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Oracle.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Oracle.Sessions.<SessionName>.Service|no| | |Named session service name to be used for connection (SID is not supported).<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Oracle.Sessions.<SessionName>.Uri|no| | |Named session connection string for Oracle.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Only `tcp` scheme is supported; a scheme can be omitted.<br>A port can be omitted (default=1521).<br>Examples: `tcp://127.0.0.1:1521`<br>`localhost`| |Plugins.Oracle.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Interval|Predeterminat|Descripció| |--|--|--|--|-----------| |Plugins.Oracle.CallTimeout|no|1-30|timeout global|Temps d'espera màxim en segons per completar una petició.| |Plugins.Oracle.ConnectTimeout|no|1-30|timeout global|Temps màxim d'espera en segons perquè s'estableixi una connexió.| |Plugins.Oracle.CustomQueriesPath|no|<|<|Camí complet d'un directori que conté fitxers .sql amb consultes personalitzades.<br>Desactivat per defecte.<br>Exemple: `/etc/zabbix/oracle/sql`| |Complements.Oracle.Default.Password|no| | |Mot de pas per defecte per connectar-se a Oracle; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Oracle.Default.Service|no| | |Nom de servei predeterminat per connectar-se a Oracle (SID no és compatible); s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Oracle.Default.Uri|no| |tcp://localhost:1521|URI per defecte per connectar-se a Oracle; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.<br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Només s'admet l'esquema `tcp`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=1521).<br>Exemples: `tcp://127.0.0.1:1521`<br>`localhost`| |Plugins.Oracle.Usuari predeterminat|no| | |Nom d'usuari per defecte per connectar-se a Oracle; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Oracle.KeepAlive|no|60-900|300|Nombre màxim de segons per esperar abans de tancar les connexions de connectors no emprades.| |Plugins.Oracle.Sessions.<SessionName>.Password|no| | |Mot de pas de sessió anomenada.<br>**<SessionName>** - estableix el nom d'una sessió que s'emprarà a les claus d'element.| |Plugins.Oracle.Sessions.<SessionName>.Service|no|<|<|Nom del servei de sessió anomenat que s'ha d'emprar per iniciar la sessió (SID no és compatible).<br>**\<SessionName\>** - defineix el nom d'una sessió que s'emprarà a l'element keys.| |Plugins.Oracle.Sessions.<SessionName>.Uri|no|<|tcp://localhost:1521|Cadena de connexió de sessió anomenada per a Oracle.<br>**<SessionName>** - estableix el nom d'una sessió per emprar-la a les claus d'element.<br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Només s'admet l'esquema `tcp`; es pot ometre un esquema..<br>Es pot ometre un port (per defecte=1521).<br>Exemples: `tcp://127.0.0.1:1521`<br>`localhost `| |Plugins.Oracle.Sessions.\<SessionName\>.User|no|<|<|Nom d'usuari de la sessió.<br>**\<SessionName\>** - defineix el nom d'una sessió que s'emprarà a les claus d'element. |  Veieu també:  - Descripció de la configuració general de l'agent Zabbix 2:       [Agent Zabbix 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Agent Zabbix 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) - Instruccions per configurar els [plugins](/manual/extensions/plugins)

en-us	### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.PostgreSQL.Default.CacheMode|no| |prepare|Cache mode for the PostgreSQL connection.<br>Supported values:<br>*prepare* (default) - will create prepared statements on the PostgreSQL server;<br>*describe* - will use the anonymous prepared statement to describe a statement without creating a statement on the server.<br>Note that "describe" is primarily useful when the environment does not allow prepared statements such as when running a connection pooler like PgBouncer.| |Plugins.PostgreSQL.CallTimeout|no|1-30|global timeout|Maximum wait time (in seconds) for a request to be completed.| |Plugins.PostgreSQL.CustomQueriesPath|no| |disabled|Full pathname of the directory containing *.sql* files with custom queries.| |Plugins.PostgreSQL.Default.Database|no| | |Default database for connecting to PostgreSQL; used if no value is specified in an item key or named session.| |Plugins.PostgreSQL.Default.Password|no| | |Default password for connecting to PostgreSQL; used if no value is specified in an item key or named session.| |Plugins.PostgreSQL.Default.TLSCAFile|no<br>(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the top-level CA(s) certificate for peer certificate verification for encrypted communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.| |Plugins.PostgreSQL.Default.TLSCertFile|no<br>(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the PostgreSQL certificate or certificate chain for encrypted communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.| |Plugins.PostgreSQL.Default.TLSConnect|no| | |Encryption type for communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.<br>Supported values:<br>*required* - connect using TLS as transport mode without identity checks;<br>*verify\_ca* - connect using TLS and verify certificate;<br>*verify\_full* - connect using TLS, verify certificate and verify that database identity (CN) specified by DBHost matches its certificate.<br>Undefined encryption type means unencrypted connection.| |Plugins.PostgreSQL.Default.TLSKeyFile|no<br>(yes, if Plugins.PostgreSQL.Default.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the PostgreSQL private key for encrypted communications between Zabbix agent 2 and monitored databases; used if no value is specified in a named session.| |Plugins.PostgreSQL.Default.Uri|no| | |Default URI for connecting to PostgreSQL; used if no value is specified in an item key or named session.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`.<br>Examples: `tcp://127.0.0.1:5432`<br>`tcp://localhost`<br>`unix:/var/run/postgresql/.s.PGSQL.5432`| |Plugins.PostgreSQL.Default.User|no| | |Default username for connecting to PostgreSQL; used if no value is specified in an item key or named session.| |Plugins.PostgreSQL.KeepAlive|no|60-900|300|Maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode|no| |prepare|Cache mode for the PostgreSQL connection.<br>**<SessionName>** - define name of a session for using in item keys.<br>Supported values:<br>*prepare* (default) - will create prepared statements on the PostgreSQL server;<br>*describe* - will use the anonymous prepared statement to describe a statement without creating a statement on the server.<br>Note that "describe" is primarily useful when the environment does not allow prepared statements such as when running a connection pooler like PgBouncer.| |Plugins.PostgreSQL.Sessions.<SessionName>.Database|no| | |Database for session connection.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.PostgreSQL.Sessions.<SessionName>.Password|no|Must match the password format.| |Password for session connection.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile|no<br>(yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to *verify_ca* or *verify_full*)| | |Full pathname of a file containing the top-level CA(s) certificate peer certificate verification.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile|yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile is specified| | |Full pathname of a file containing the PostgreSQL certificate or certificate chain.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect|no| | |Encryption type for PostgreSQL connection.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Supported values:<br>*required* - connect using TLS as transport mode without identity checks;<br>*verify\_ca* - connect using TLS and verify certificate;<br>*verify\_full* - connect using TLS, verify certificate and verify that database identity (CN) specified by DBHost matches its certificate.<br>Undefined encryption type means unencrypted connection.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile|yes, if Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile is specified| | |Full pathname of a file containing the PostgreSQL private key.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.PostgreSQL.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`.<br>Examples: `tcp://127.0.0.1:5432`<br>`tcp://localhost`<br>`unix:/var/run/postgresql/.s.PGSQL.5432`| |Plugins.PostgreSQL.Sessions.<SessionName>.User|no| | |Named session username.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.PostgreSQL.System.Path|yes| | |Path to external plugin executable.| |Plugins.PostgreSQL.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	### Paràmetres  |Paràmetre|Obligatori|Rang|Predeterminat|Descripció| |--|--|--|--|-----------| |Plugins.PostgreSQL.Default.CacheMode|no| |prepare|Mode cau per la connexió de PostgreSQL.<br>Valors admesos:<br>*preparar* (per defecte) - crearà enunciats preparats al servidor PostgreSQL;<br>*descriure* - emprarà l'enunciat anònim preparat per descriure l'enunciat sense crear un enunciat al servidor.<br>Veieu que "descriure" és útil principalment quan l'entorn no permet enunciats preparats com executant una connexió agrupada com ara PgBouncer.| |Plugins.PostgreSQL.CallTimeout|no|1-30|temps d'espera global|Temps d'espera màxim (en segons) per completar una petició.| |Plugins.PostgreSQL.CustomQueriesPath|no| |disabled|Camí complet del directori que conté fitxers *.sql* amb consultes personalitzades.| |Plugins.PostgreSQL.Default.Database|no| | |Base de dades per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.PostgreSQL.Default.Password|no| | |Mot de pas per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.PostgreSQL.Default.TLSCAFile|no<br>sí, si Plugins.PostgreSQL.Default.TLSConnect és configurat a *verify_ca* o *verify_full*| | |Camí d'accés complet d'un fitxer que conté el certificat de CA(s) de nivell superior per a la verificació del certificat d'iguals per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.PostgreSQL.Default.TLSCertFile|no<br>sí, si Plugins.PostgreSQL.Default.TLSConnect s'estableix a *verify_ca* o *verify_full*| | |Camí complet d'un fitxer que conté el certificat PostgreSQL o la cadena de certificats per a comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.PostgreSQL.Default.TLSConnect|no| | |Tipus de xifrat per a les comunicacions entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió amb nom.<br>Valors admesos:<br>*obligatori* - connecteu-vos mitjançant TLS com a mode de transport sense comprovacions d'identitat;<br>*verify\_ca* - connecteu-vos mitjançant TLS i verifiqueu el certificat; <br>*verify\_full* - connecteu-vos mitjançant TLS, verifiqueu el certificat i verifiqueu que la identitat de la base de dades (CN) especificada per DBHost coincideix amb el seu certificat.<br>El tipus de xifrat no definit significa connexió sense xifrar.| |Plugins.PostgreSQL.Default.TLSKeyFile|no<br>(sí, si Plugins.PostgreSQL.Default.TLSConnect s'estableix en un dels següents: verify_ca, verify_full)| | |Camí complet d'un fitxer que conté la clau privada de PostgreSQL per a les comunicacions xifrades entre l'agent Zabbix 2 i les bases de dades monitorades; s'empra si no s'especifica cap valor en una sessió anomenada.| |Plugins.PostgreSQL.Default.Uri|no| | |URI per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.<br><br>No han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`.<br>Exemples: `tcp://127.0.0.1:5432`<br>`tcp://localhost`<br>`unix:/var/run/postgresql/.s.PGSQL.5432`| |Plugins.PostgreSQL.Default.User|no| | |Nom d'usuari per defecte per connectar-se a PostgreSQL; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.PostgreSQL.KeepAlive|no|60-900|300|Temps màxim d'espera (en segons) abans que es tanquin les connexions de connectors no emprats.| |Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode|no| |prepare|Mode cau per la connexió de PostgreSQL.<br>**<SessionName>** - defineix el nom de la sessió per emprar-lo a les claus d'element.<br>Valors admesos:<br>*preparar* (per defecte) - crearà enunciats preparats al servidor PostgreSQL;<br>*descriure* - emprarà l'enunciat anònim preparat per descriure l'enunciat sense crear un enunciat al servidor.<br>Veieu que "descriure" és útil principalment quan l'entorn no permet enunciats preparats com executant una connexió agrupada com ara PgBouncer.<br>Admès des de la versió 6.4.10| |Plugins.PostgreSQL.Sessions.<SessionName>.Database|no| | |Base de dades per a la connexió de la sessió.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.PostgreSQL.Sessions.<SessionName>.Password|no|Ha de coincidir amb el format del mot de pas.| |Mot de pas per a la connexió de sessió.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSCAFile|no<br>sí, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'ha establert a *verify_ca* o *verify_full*| | |Camí d'accés complet d'un fitxer que conté la verificació del certificat d'iguals del certificat de CA(s) de nivell superior.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile|no<br>(sí, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'estableix a *verify_ca* o *verify_full*)| | |Camí complet d'un fitxer que conté el certificat PostgreSQL o la cadena de certificats.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect|no| | |Tipus de xifrat per a la connexió PostgreSQL.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>Valors admesos:<br>*obligatori* - connecteu-vos mitjançant TLS com a transport mode sense comprovacions d'identitat;<br>*verify\_ca* - connecteu mitjançant TLS i verificar el certificat;<br>*verify\_full* - connecteu mitjançant TLS, verificar el certificat i verificar que la identitat de la base de dades (CN) especificada per DBHost coincideix amb el seu certificat.<br>El tipus de xifrat no definit significa connexió sense xifrar.| |Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile|no<br>sí, si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'estableix a *verify_ca* o *verify_full*| | |Camí d'accés complet d'un fitxer que conté la clau privada de PostgreSQL.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la en claus d'elements.| |Plugins.PostgreSQL.Sessions.<SessionName>.Uri|no| | |Cadena de connexió d'una sessió amb nom.<br>**<SessionName>** - defineix el nom d'una sessió per emprar-la a les claus d'element.<br><br>No hauria d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`.<br>Exemples: `tcp://127.0.0.1:5432`<br>`tcp://localhost`<br> `unix:/var/run/postgresql/.s.PGSQL.5432`| |Plugins.PostgreSQL.Sessions.<SessionName>.Usuari|no| | |Nom d'usuari de la sessió.<br>**<Nom de la sessió>** - defineix el nom d'una sessió per emprar-la a les claus d'elements.| |Plugins.PostgreSQL.System.Path|sí| | |Camí a l'executable del connector extern.| |Plugins.PostgreSQL.Timeout|no|1-30|temps d'espera global|Temps d'espera d'execució de la petició (quant de temps s'ha d'esperar que es completi una petició abans d'apagar-la).|  Veieu també:  - Descripció dels paràmetres de configuració generals de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) - Instruccions per configurar [connectors](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Redis.Default.Password|no| | |Default password for connecting to Redis; used if no value is specified in an item key or named session.| |Plugins.Redis.Default.Uri|no| |tcp://localhost:6379|Default URI for connecting to Redis; used if no value is specified in an item key or named session. <br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted.<br>A port can be omitted (default=6379).<br>Examples: `tcp://localhost:6379`<br>`localhost`<br>`unix:/var/run/redis.sock`| |Plugins.Redis.KeepAlive|no|60-900|300|The maximum time of waiting (in seconds) before unused plugin connections are closed.| |Plugins.Redis.Sessions.<SessionName>.Password|no| | |Named session password.<br>**<SessionName>** - define name of a session for using in item keys.| |Plugins.Redis.Sessions.<SessionName>.Uri|no| | |Connection string of a named session.<br>**<SessionName>** - define name of a session for using in item keys.<br><br>Should not include embedded credentials (they will be ignored).<br>Must match the URI format.<br>Supported schemes: `tcp`, `unix`; a scheme can be omitted.<br>A port can be omitted (default=6379).<br>Examples: `tcp://localhost:6379`<br>`localhost`<br>`unix:/var/run/redis.sock`| |Plugins.Redis.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Interval|Predeterminat|Descripció| |--|--|--|--|-----------| |Plugins.Redis.Default.Password|no| | |Mot de pas per defecte per connectar-se a Redis; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom.| |Plugins.Redis.Default.Uri|no| |tcp://localhost:6379|URI per defecte per connectar-se a Redis; s'empra si no s'especifica cap valor en una clau d'element o sessió amb nom. <br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp`, `unix`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=6379).<br>Exemples: `tcp://localhost:6379`<br>`localhost`<br> `unix:/var/run/redis.sock`| |Plugins.Redis.KeepAlive|no|60-900|300|Temps d'espera màxim (en segons) abans de tancar les connexions de connectors no emprades.| |Plugins.Redis.Sessions.<SessionName>.Password|no|<|<|Mot de pas de la sessió anomenada.<br>**<SessionName>** - nom d'una sessió que s'emprarà a l'element keys.| |Plugins.Redis.Sessions.<SessionName>.Uri|no|<|tcp://localhost:6379|Cadena de connexió de sessió anomenada.<br>**<SessionName>** - nom d'una sessió per emprar-la en claus d'element .<br><br>No s'han d'incloure credencials incrustades (s'ignoraran).<br>Ha de coincidir amb el format URI.<br>Esquemes admesos: `tcp `, `unix`; es pot ometre un esquema.<br>Es pot ometre un port (per defecte=6379).<br>Exemples: `tcp://localhost:6379`<br>`localhost`< br> `unix:/var/run/redis.sock`| |Plugins.Redis.Sessions.<SessionName>.User|no|<|<|Nom d'usuari de la sessió.<br>**<SessionName>** - nom d'una sessió que s'emprarà a l'element.| |Plugins.Redis.Timeout|no|1-30|temps d'espera global|Temps d'espera d'execució de consultes (quant de temps s'ha d'esperar que acabi una consulta abans d'aturar-la).|  Veieu també:  - Descripció de la configuració general de l'agent Zabbix 2: [Zabbix 2 Agent (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix 2 Agent (Windows)](/manual/appendix/config/zabbix_agent2_win ) - Instruccions per configurar els [plugins](/manual/extensions/plugins)

en-us	#### Parameters  |Parameter|Mandatory|Range|Default|Description| |--|--|--|--|----------| |Plugins.Smart.Path|no| |smartctl|Path to the smartctl executable.| |Plugins.Smart.Timeout|no|1-30|global timeout|Request execution timeout (how long to wait for a request to complete before shutting it down).|  See also:  -   Description of general Zabbix agent 2 configuration parameters:     [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) /     [Zabbix agent 2     (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instructions for configuring [plugins](/manual/extensions/plugins)
ca	#### Paràmetres  |Paràmetre|Obligatori|Rang|Per defecte|Descripció| |--|--|--|--|----------| |Plugins.Smart.Path|no| |smartctl|Ruta a l'executable smartctl.| |Plugins.Smart.Timeout|no|1-30|global timeout|Espera d'execució de la petició (quan de temps ha d'esperar que una petició acabi abans de tancar).|  Veieu també:  -   Descripció dels paràmetres generals de configuració de l'agent Zabbix 2: [Zabbix agent 2 (UNIX)](/manual/appendix/config/zabbix_agent2) / [Zabbix agent 2 (Windows)](/manual/appendix/config/zabbix_agent2_win) -   Instruccions per la configuració dels [plugins](/manual/extensions/plugins)

en-us	#### Parameters  Parameters in this file that could be of interest to users:  -   ZBX\_MIN\_PERIOD  Minimum graph period, in seconds. One minute by default.  -   GRAPH\_YAXIS\_SIDE\_DEFAULT  Default location of Y axis in simple graphs and default value for drop down box when adding items to custom graphs. Possible values: 0 - left, 1 - right.  Default: 0  -   ZBX\_SESSION\_NAME  String used as the name of the Zabbix frontend session cookie.  Default: zbx\_sessionid  -   ZBX\_DATA\_CACHE\_TTL  TTL timeout in seconds used to invalidate data cache of [Vault response](/manual/config/secrets). Set 0 to disable Vault response caching.  Default: 60  -   SUBFILTER\_VALUES\_PER\_GROUP  Number of subfilter values per group (For example, in the [latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) subfilter).  Default: 1000
ca	#### Paràmetres  Paràmetres d'aquest fitxer que poden ser d'interès per als usuaris:  - ZBX\_MIN\_PERIOD  Període mínim del gràfic, en segons. Un minut per defecte.  - GRÀFIC\_YAXIS\_SIDE\_DEFAULT  Ubicació predeterminada de l'eix Y en gràfics simples i valor desplegable predeterminat en afegir elements als gràfics personalitzats. Valors possibles: 0 - esquerra, 1 - dreta.  Per defecte: 0  - ZBX\_SESSION\_NAME  La cadena s'empra com a nom de la galeta de sessió frontal de Zabbix.  Per defecte: zbx\_sessioniid  - ZBX\_DATA\_CACHE\_TTL  Temps d'espera TTL en segons emprat per invalidar la memòria cau de dades de [resposta de Vault](/manual/config/secrets). Establiu a 0 per desactivar la memòria cau de respostes de Vault.  Per defecte: 60  - SUBFILTER\_VALUES\_PER\_GROUP  Nombre de valors de subfiltre per grup (per exemple, al subfiltre [darreres dades](/manual/web_interface/frontend_sections/monitoring/latest_data)).  Per defecte: 1000

en-us	#### Parameters  The following parameters are available for this item:  -   **active** - memory currently in use or very recently used, and so     it is in RAM -   **anon** - memory not associated with a file (cannot be re-read from     it) -   **available** - available memory, calculated differently depending     on the platform (see the table below) -   **buffers** - cache for things like file system metadata -   **cached** - cache for various things -   **exec** - executable code, typically from a (program) file -   **file** - cache for contents of recently accessed files -   **free** - memory that is readily available to any entity requesting     memory -   **inactive** - memory that is marked as not used -   **pavailable** - 'available' memory as percentage of 'total'     (calculated as `available`/`total`\*100) -   **pinned** - same as 'wired' -   **pused** - 'used' memory as percentage of 'total' (calculated as     `used`/`total`\*100) -   **shared** - memory that may be simultaneously accessed by multiple     processes -   **slab** - total amount of memory used by the kernel to cache data     structures for its own use -   **total** - total physical memory available -   **used** - used memory, calculated differently depending on the     platform (see the table below) -   **wired** - memory that is marked to always stay in RAM. It is never     moved to disk.  ::: notewarning Some of these parameters are platform-specific and might not be available on your platform. See [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent#virtual_memory_data) for details. :::  Platform-specific calculation of **available** and **used**:  |Platform|**"available"**|**"used"**| |--------|---------------|----------| |*AIX*|free + cached|real memory in use| |*FreeBSD*|inactive + cached + free|active + wired + cached| |*HP UX*|free|total - free| |*Linux<3.14*|free + buffers + cached|total - free| |*Linux 3.14+*<br>(also backported to 3.10 on RHEL 7)|/proc/meminfo, see "MemAvailable" in Linux kernel [documentation](https://www.kernel.org/doc/Documentation/filesystems/proc.txt) for details.<br>Note that free + buffers + cached is no longer equal to 'available' due to not all the page cache can be freed and low watermark being used in calculation.|total - free| |*NetBSD*|inactive + execpages + file + free|total - free| |*OpenBSD*|inactive + free + cached|active + wired| |*OSX*|inactive + free|active + wired| |*Solaris*|free|total - free| |*Win32*|free|total - free|  ::: noteimportant The sum of *vm.memory.size\[used\]* and *vm.memory.size\[available\]* does not necessarily equal total. For instance, on FreeBSD:\ \* Active, inactive, wired, cached memories are considered used, because they store some useful information.\ \* At the same time inactive, cached, free memories are considered available, because these kinds of memories can be given instantly to processes that request more memory.\ \ So inactive memory is both used and available simultaneously. Because of this, the *vm.memory.size\[used\]* item is designed for informational purposes only, while *vm.memory.size\[available\]* is designed to be used in triggers. :::
ca	 #### Paràmetres  Els paràmetres següents són disponibles per aquest element:  -   **active** - memòria emprada actualment o emprada recentment; és a dir, que és a la RAM -   **anon** - memòria no associada a un arxiu (no es pot rellegir a partir d'ell) -   **available** - memòria disponible, calculada de manera diferent segons la plataforma veieu la taula de sota) -   **buffers** - cau per metadades i sistema de fitxers -   **cached** - cau per altres coses -   **exec** - codi executable, generalment a partir d'un arxiu (o programa) -   **file** - cau per contingut dels darrers accessos a arxius -   **free** - memòria fàcilment disponible per tota entitat que demani memòria -   **inactive** - memòria marcada com a no emprada -   **pavailable** - memòria 'disponible' en percentatge del 'total' (calculada com 'available'/'total'\*100) -   **pinned** - igual que 'wired' -   **pused** - memòria 'emprada' en percentatge del 'total' (calculada com `used`/`total`\*100) -   **shared** - memòria accessible simultàniament per diversos processos -   **slab** - quantitat total de memòria emprada per el kernel per posar a la cau les estructures de dades per al seu propi ús -   **total** - memòria física total disponible -   **used** - memòria emprada, calculada de manera diferent segons la plataforma (veieu la taula de sota) -   **wired** - memòria marcada per romandre sempre a la RAM. Mai es mourà a disc.  ::: notewarning Alguns d'aquests paràmetres detallats a la plataforma poden no ésser disponibles sota la vostra plataforma. Veieu [Elements suportats per la plataforma](/manual/appendix/items/supported_by_platform) per tindre més detalls. :::  Càlcul específic a la plataforma d'**available** i **used**:  |Plataforma|**"available"**|**"used"**| |--------|---------------|----------| |*AIX*|free + cached|memòria real emprada| |*FreeBSD*|inactive + cached + free|active + wired + cached| |*HP UX*|free|total - free| |*Linux<3.14*|free + buffers + cached|total - free| |*Linux 3.14+*<br>(també retroportada a 3.10 sota RHEL 7)|/proc/meminfo; per tindre més detalls, veieu "MemAvailable" a la [documentació de Kernel de Linux](https://www.kernel.org/doc/Documentation/filesystems/proc.txt).<br>eieu que free + buffers + cached no és el mateix que 'available' doncs la cau de paginació no es pot pas alliberar i la filigrana s'empra al càlcul.|total - free| |*NetBSD*|inactive + execpages + file + free|total - free| |*OpenBSD*|inactive + free + cached|active + wired| |*OSX*|inactive + free|active + wired| |*Solaris*|free|total - free| |*Win32*|free|total - free|  ::: noteimportant La suma de *vm.memory.size\[used\]* i *vm.memory.size\[available\]* no és pas necessàriament igual al total. Per exemple, sota FreeBSD :\ \* Les memòries activa, inactiva, wired i cau es consideren com emprades, doncs emmagatzemen informació útil.\ \* Al mateix temps, les memòries inactives, cau i alliberades es consideren disponibles, doncs aquest tipus de memòria poden donar-se ràpidament als processos que demanin més memòria.\ \ Per tant, la memòria inactiva també s'empra i és disponible simultàniament. Per això, l'element *vm.memory.size\[used\]* és dissenyat només com a propòsit informatiu, mentre que  *vm.memory.size\[available\]* és dissenyat per emprar-lo als triggers. :::

en-us	### Parameters  The following parameters are supported for the *Action log* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|-----|-|-----|-------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Recipients*|<|11|userids.0|[User](/manual/api/reference/user/get) ID.<br><br>Note: To configure multiple users, create a dashboard widget field object for each user with an incremented number in the property name.| |*Actions*|<|12|actionids.0|[Action](/manual/api/reference/action/get) ID.<br><br>Note: To configure multiple actions, create a dashboard widget field object for each action with an incremented number in the property name.| |*Media types*|<|13|mediatypeids.0|[Media type](/manual/api/reference/mediatype/get) ID.<br><br>Note: To configure multiple media types, create a dashboard widget field object for each media type with an incremented number in the property name.| |*Status*|<|0|statuses.0|0 - In progress;<br>1 - Sent/Executed;<br>2 - Failed.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.| |*Search string*|<|1|message|Any string value.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |*Sort entries by*|<|0|sort_triggers|3 - Time (ascending);<br>4 - *(default)* Time (descending);<br>5 - Type (ascending);<br>6 - Type (descending);<br>7 - Status (ascending);<br>8 - Status (descending);<br>11 - Recipient (ascending);<br>12 - Recipient (descending).| |*Show lines*|<|0|show_lines|Possible values range from 1-100.<br><br>Default: 25.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Registre d'accions*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Destinataris*|<|11|identificacions d'usuari|[Usuari](/manual/api/reference/user/get) ID.<br><br>Nota: per configurar diversos usuaris, creeu un objecte de camp de giny de tauler per a cada usuari.| |*Accions*|<|12|actionids|[Acció](/manual/api/reference/action/get) ID.<br><br>Nota: per configurar diverses accions, creeu un objecte de camp de giny del tauler de control per a cada acció.| |*Tipus de suport*|<|13|mediatypeids|[Tipus de suport](/manual/api/reference/mediatype/get) ID.<br><br>Nota: per configurar diversos tipus de suport, creeu un objecte de camp de giny de tauler per a cada tipus de suport.| |*Estat*|<|0|estats|0 - En curs;<br>1 - Enviat/Executat;<br>2 - Ha fallat.<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Cadena de cerca*|<|1|missatge|Qualsevol valor de cadena.| |*Període de temps*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - establiu la [tria de *Període de temps*](/manual/web_interface/time_period_selector) com a origen de dades;<br>`ABCDE._timeperiod` - definiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* establert a "`ABCDE`") com a orígen de dades.<br><br>Per defecte: `DASHBOARD._timeperiod`<br><br>Alternativament, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.| |<|*Des de*|1|time_period.from|Cadena de temps vàlida en sintaxi absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Període de temps* no és pas definit| |^|*Fins a*|1|time_period.to|Cadena de temps vàlida en sintaxi absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).<br><br>Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Període de temps* no és pas definit| |*Ordenar les entrades per*|<|0|sort_triggers|3 - Temps (creixent);<br>4 - *(per defecte)* Temps (decreixent);<br>5 - Tipus (ascendent);<br>6 - Tipus ( descendent);<br>7 - Estat (creixent);<br>8 - Estat (decreixent);<br>11 - Destinatari (ascendent);<br>12 - Destinatari (descendent).| |*Mostra les línies*|<|0|mostra_línies|Els valors vàlids van d'1 a 100.<br><br>Per defecte: 25.|

en-us	### Parameters  The following parameters are supported for the *Clock* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Time type*|0|time_type|0 - *(default)* Local time;<br>1 - Server time;<br>2 - Host time.| |*Clock type*|0|clock_type|0 - *(default)* Analog;<br>1 - Digital.|  The following parameters are supported if *Time type* is set to "Host time".  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Item*|4|itemid.0|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|  The following parameters are supported if *Clock type* is set to "Digital".  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show*|0|show.0|1 - Date;<br>2 - *(default)* Time;<br>3 - Time zone.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Rellotge*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.| |*Tipus d'hora*|0|tipus_hora|0 - *(per defecte)* Hora local;<br>1 - Hora del servidor;<br>2 - Hora de l'equip.| |*Tipus de rellotge*|0|tipus_rellotge|0 - *(per defecte)* Analògic;<br>1 - Digital.|  Els paràmetres següents s'admeten si el *Tipus de temps* s'estableix a "Hora de l'equip".  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Element*|4|itemid|[Eement](/manual/api/reference/item/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori*|  Els paràmetres següents s'admeten si el *Tipus de rellotge* és configurat a "Digital".  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Mostra*|<|0|mostra|1 - Data;<br>2 - *(per defecte)* Hora;<br>3 - Zona horària.<br><br>Nota: per configurar diversos valors, creeu un objecte camp del giny del tauler de control per a cada valor.| |*Configuració avançada*|<|0|adv_conf|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>El paràmetre *Configuració avançada* s'ha d'establir com a "Habilitat" per configurar *Color de fons* i totes les opcions per a *Data*, *Hora* i *Zona horària*.| |*Color de fons*|<|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Data*|<|<|<|<| |<|*Mida*|0|date_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 20.| |^|*Negreta*|0|date_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |^|*Color*|1|date_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Hora*|<|<|<|<| |<|*Mida*|0|time_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 30.| |^|*Negreta*|0|time_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |^|*Color*|1|time_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |^|*Segons*|0|time_sec|0 - Inhabilitat;<br>1 - *(per defecte)* Habilitat.| |^|*Format*|0|time_format|0 - *(per defecte)* 24 hores;<br>1 - 12 hores.| |*Fus horari*|<|<|<|<| |<|*Mida*|0|tzone_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 20.| |^|*Negreta*|0|tzone_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |^|*Color*|1|tzone_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |^|*Zona horària*|1|tzone_timezone|Cadena de zona horària vàlida (p. ex., `Europa/Riga`, `system`, `UTC`, etc.). Per obtindre la llista completa de zones horàries admeses, consulteu [documentació PHP](https://www.php.net/manual/en/timezones.php).<br><br>Per defecte: `local`.<br> <br>El paràmetre *Zona horària* no és disponible si el *Tipus d'hora* és establert a "Hora de l'equip".| |^|*Format*|0|tzone_format|0 - *(per defecte)* Curt;<br>1 - Sencer.<br><br>El paràmetre *Format* no és disponible si el *Tipus d'hora* s'ha establert a "Hora de l'equip ".|

en-us	### Parameters  The following parameters are supported for the *Data overview* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Item tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |^|*Operator*|0|tags.0.operator|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Item tags*| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hosts location*|<|0|style|0 - *(default)* Left;<br>1 - Top.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Vista general de dades*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids.0|ID del [Grup d'equips](/manual/api/reference/hostgroup/get).<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Grups d'equips (Giny)*|1|groupids.0|En lloc d'ID de [Grup d'equips](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostgroupids` - establiu un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* establert a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip amb un nombre incrementat a la propietat del nom. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de configurar amb almenys un grup d'equips al qual pertanyen els equips configurats.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|Enlloc d'ID d'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - defineix la [tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - defineix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* definit a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Etiquetes d'elements*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.0.tag|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>Nota: el nombre al nom de la propietat fa referència a l'ordre d'etiqueta de la llista d'avaluació d'etiquetes<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.0.value|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |*Mostra els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Ubicació de l'equip*|<|0|estil|0 - *(per defecte)* Esquerra;<br>1 - Amunt.|

en-us	### Parameters  The following parameters are supported for the *Discovery status* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny d'*Estat de descoberta*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Favorite graphs* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *Gràfics preferits*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Favorite maps* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *Mapes preferits*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Gauge* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|-----|-|-----|-------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Item*|<|4|itemid.0|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Item (Widget)* is not set| |<|*Item (Widget)*|1|itemid.\_reference|Instead of [Item](/manual/api/reference/item/get) ID:<br>`ABCDE._itemid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for items.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Item* is not set| |*Min*|<|1|min|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.<br><br>Default: "0".| |*Max*|<|1|max|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.<br><br>Default: "100".| |*Value arc*|<|1|value_arc_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Arc background*|<|1|empty_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Background*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Show*|<|0|show.0|1 - Description;<br>2 - Value;<br>3 - Needle;<br>4 - Scale;<br>5 - Value arc.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value with an incremented number in the property name.<br><br>Default: 1, 2, 4, 5.<br><br>Values "Needle" and "Scale" are not supported if both:<br>- no dashboard widget field object for *Show* with the value "Value arc" is set;<br>- *Show arc* [advanced configuration](#advanced-configuration) parameter is set to "Disabled".<br><br>[Advanced configuration](#advanced-configuration) parameters for *Show* options are not supported if no dashboard widget field objects with the respective values are set.| |*Override host*|<|1|override_hostid.\_reference|`ABCDE._hostid` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts;<br>`DASHBOARD._hostid` - set the dashboard [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Calibre*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Element*|<|4|itemid.0|[Element](/manual/api/reference/item/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |<|*(Giny) d'element*|1|itemid.\_reference|Enlloc de l'ID de l'[Element](/manual/api/reference/item/get):<br>`ABCDE._itemid` - defineix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* definit a "`ABCDE`") com a font de dades per als elements.<br><br>[Comportament de la propitat](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Element* no s'ha pas definit| |*Min*|<|1|min|Qualsevol valor numèric. S'admeten [Sufixos](/manual/appendix/sufixos) (p.e., "1d", "2w", "4K", "8G").<br><br>Per defecte: "0".| |*Max*|<|1|max|Qualsevol valor numèric. S'admeten [Sufixos](/manual/appendix/sufixos) (p.e., "1d", "2w", "4K", "8G").<br><br>Per defecte: "100".| |*Valor arc*|<|1|value_arc_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Arc de fons*|<|1|empty_color|Codi de color hexadecimal (per exemple, `FF0000`).<br><br>Per defecte: `""` (buit).| |*Color de fons*|<|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Vista*|<|0|show.0|1 - Descripció;<br>2 - Valor;<br>3 - Agulla;<br>4 - Escala;<br>5 - Arc de valor.<br><br> Nota: per configurar diversos valors, creeu un objecte de camp de giny del tauler de control per a cada valor amb un nombre incrementat al nom de la propietat.<br><br>Per defecte: 1, 2, 4, 5.<br><br>Valors "Agulla" i "Escala" no s'admeten si tots dos:<br>- no hi ha cap objecte de camp del giny del tauler de control per a *Vista* amb el valor "Arc de valor";<br>- *Veure l'arc* [configuració avançada](#avanzada- El paràmetre de configuració) s'estableix a "Desactivat".<br><br>Els paràmetres [Configuració avançada](#advanced-configuration) per a les opcions *Vista* no s'admeten si no s'estableix cap objecte de camp de giny del tauler de control amb els valors respectius.| |*Substitueix l'equip*|<|1|override_hostid._reference|`ABCDE._hostid` - estableix un giny compatible (*Navegador de l'equip* amb el seu paràmetre *Referència* definit en "`ABCDE`") com a font de dades que conté l'equip.< br>`DASHBOARD._hostid`: defineix el tauler [tria d'*Equip* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades que conté l'equip.<br><br>Aquest paràmetre és no s'admet si es configura el giny en un [tauler de plantilla](/manual/api/reference/templatedashboard/object).|

en-us	### Parameters  The following parameters are supported for the *Geomap* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids.0|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group with an incremented number in the property name.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Host groups (Widget)*|1|groupids.\_reference|Instead of [Host group](/manual/api/reference/hostgroup/get) ID:<br>`ABCDE._hostgroupids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for host groups.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Hosts*|<|3|hostids.0|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host with an incremented number in the property name. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |<|*Hosts (Widget/Dashboard)*|1|hostids.\_reference|Instead of [Host](/manual/api/reference/host/get) ID:<br>`DASHBOARD.hostids` - set the [*Host* selector](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) as the data source for hosts;<br>`ABCDE._hostids` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source for hosts.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Tags*|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag name*|1|tags.0.tag|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Operator*|0|tags.0.operator|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |^|*Tag value*|1|tags.0.value|Any string value.<br><br>Note: The number in the property name references tag order in the tag evaluation list.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*<br><br>This parameter is not supported if configuring the widget on a [template dashboard](/manual/api/reference/templatedashboard/object).| |*Initial view*|<|1|default_view|Comma separated *latitude*, *longitude*, *zoom level* (*optional*, possible values range from 0-30).<br>Example: `40.6892494,-74.0466891,10`.| |*Reference*|<|1|reference|Any string value consisting of 5 characters (e.g., `ABCDE` or `JBPNL`). This value must be unique within the dashboard to which the widget belongs.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Geomapes*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids.0|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| Enlloc de l'ID del [Grup d'equips](/manual/api/reference/hostgroup/get):<br>`ABCDE._hostids` - defineix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* definit a "`ABCDE`") com a font de dades per als grups d'equips.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Equips*|<|3|hostids.0|ID de l'[equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de fer amb almenys un grup d'equips al qui pertanyen els equips configurats.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |<|*Equips (Giny/Tauler)*|1|hostids.\_reference|Enlloc de l'ID de l'[Equip](/manual/api/reference/host/get):<br>`DASHBOARD.hostids` - estableix la [tria d'*Equip*](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) com a font de dades per als equips;<br>`ABCDE._hostids` - defineix un [giny compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (amb el seu paràmetre de *Referència* definit a "`ABCDE`") com a font de dades per als equips.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Etiquetes*|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Operador*|0|tags.0.operator|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*<br><br>Aquest paràmetre no s'admet pas si es configura el giny a un [tauler de plantilla](/manual/api/reference/templatedashboard/object).| |*Vista inicial*|<|1|vista_predeterminada|Separat per comes *latitud*, *longitud*, *nivell de zoom* (*opcional*, els valors vàlids van de 0 a 30).<br>Exemple: `40.6892494,-74.0466891 ,10`.| |*Referència*|<|1|reference|Qualsevol valor de cadena consistent en 5 caràcters(com ara `ABCDE` o `JBPNL`). Aquest valor ha d'ésser únic al tauler on pertany el giny.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*|