en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |active|flag|Return only enabled trigger prototypes that belong to monitored hosts.| |discoveryids|string/array|Return only trigger prototypes that belong to the given LLD rules.| |functions|string/array|Return only triggers that use the given functions.<br><br>Refer to the [Supported functions](/manual/appendix/functions) page for a list of supported functions.| |group|string|Return only trigger prototypes that belong to hosts from the host groups with the given name.| |groupids|string/array|Return only trigger prototypes that belong to hosts from the given host groups.| |host|string|Return only trigger prototypes that belong to hosts with the given name.| |hostids|string/array|Return only trigger prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only trigger prototypes inherited from a template.| |maintenance|boolean|If set to `true` return only enabled trigger prototypes that belong to hosts in maintenance.| |min\_severity|integer|Return only trigger prototypes with severity greater or equal than the given severity.| |monitored|flag|Return only enabled trigger prototypes that belong to monitored hosts and contain only enabled items.| |templated|boolean|If set to `true` return only trigger prototypes that belong to templates.| |templateids|string/array|Return only trigger prototypes that belong to the given templates.| |triggerids|string/array|Return only trigger prototypes with the given IDs.| |expandExpression|flag|Expand functions and macros in the trigger expression.| |selectDependencies|query|Return trigger prototypes and triggers that the trigger prototype depends on in the `dependencies` property.| |selectDiscoveryRule|query|Return the [LLD rule](/manual/api/reference/discoveryrule/object) that the trigger prototype belongs to.| |selectFunctions|query|Return functions used in the trigger prototype in the `functions` property.<br><br>The function objects represent the functions used in the trigger expression and has the following properties:<br>`functionid` - *(string)* ID of the function;<br>`itemid` - *(string)* 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.| |selectGroups|query|Return the host groups that the trigger prototype belongs to in the [groups](/manual/api/reference/hostgroup/object) property.| |selectHosts|query|Return the hosts that the trigger prototype belongs to in the [hosts](/manual/api/reference/host/object) property.| |selectItems|query|Return items and item prototypes used the trigger prototype in the [items](/manual/api/reference/item/object) property.| |selectTags|query|Return the trigger prototype tags in [tags](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag) property.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, 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 additional filters:<br>`host` - technical name of the host that the trigger prototype belongs to;<br>`hostid` - ID of the host that the trigger prototype 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 the result by the given properties.<br><br>Possible values are: `triggerid`, `description`, `status` and `priority`.| |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  `(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ó| |--|--|------| |active|flag|Retorna només els prototips activats que pertanyen als equips monitoritzats.| |discoveryids|string/array|Retorna només prototips de triggers que pertanyen a les regles LLD donades.| |functions|string/array|Retorna només triggers que utilitzen les funcions donades.<br><br>Consulteu la pàgina [trigger functions](/ca/manual/appendix/triggers/functions) per obtenir una llista de funcions admeses. | |grup|string|Retorna només prototips de triggers que pertanyen als equips dels grups donats.| |groupids|string/array|Retorna només prototips de triggers que pertanyen als equips dels grups donats.| |host|string|Retorna només prototips de triggers que pertanyen als equips donats.| |hostids|string/array|Retorna només els prototips de triggers que pertanyen als equips donats.| |inherited|boolean|Si s'estableix a `true`, només retorna els prototips de triggers heretats d'una plantilla.| |manteinance|boolean|Si s'estableix a `true`, només es retornen els prototips de triggers que pertanyen als equips en manteniment.| |min\_severity|integer|Retorn només els prototips de triggers la gravetat dels quals és superior o igual a la gravetat donada.| |monitored|flag|Retorna només prototips de triggers activats que pertanyen a equips supervisats i que només contenen elements activats.| |template|boolean|Si s'estableix com a `true`, només retorna prototips de triggers que pertanyen a plantilles.| |templateids|string/array|Retorna només prototips de triggers que pertanyen a les plantilles donades.| |triggerids|string/array|Retorna només els prototips de triggers amb els ID donats.| |expandExpression|flag|Amplieu les funcions i les macros a l'expressió de trigger.| |selectDependencies|query|Retorna els prototips del trigger i els triggers dels quals depèn el prototip del trigger a la propietat `dependencies`.| |selectDiscoveryRule|query|Retorna la [regla LLD](/manual/api/reference/discoveryrule/object) a la qual pertany el prototip del trigger.| |selectFunctions|query|Retorna les funcions emprades en el prototip de trigger a la propietat `functions`.<br><br>Els objectes de funció representen les funcions emprades a l'expressió de trigger i tenen les propietats següents:<br>` functionid` - * (cadena)* ID de la funció;<br>`itemid` - *(cadena)* ID de l'element emprat a la funció;<br>`funció` - *(cadena)* nom de la funció;<br>`paràmetre' - El paràmetre *(cadena)* que s'ha passat a la funció. El paràmetre de consulta es substitueix pel símbol `$` a la cadena retornada.| |selectGroups|query|Retorna els grups d'equips als quals pertany el prototip del trigger a la propietat [grups](/manual/api/reference/hostgroup/object).| |selectHosts|query|Retorna els equips als quals pertany el prototip de trigger a la propietat [equips](/manual/api/reference/host/object).| |selectItems|query|Retorna els elements i els prototips d'elements emprats pel prototip de trigger a la propietat [elements](/manual/api/reference/item/object).| |selectTags|query|Retorna les etiquetes del prototip de trigger a la propietat [etiquetes](/manual/api/reference/triggerprototype/object#Trigger_prototype_tag).| |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>Compatibilitat amb filtres addicionals:<br>`host` - nom tècnic de l'equip al qual pertany el prototip de trigger;<br>`hostid` - ID de l'equip al qual pertany el prototip de 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 el resultat per les propietats donades.<br><br>Valors possibles: `triggerid`, `description`, `status` i `priority`.| |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| |--|--|------| |alertids|string/array|Return only alerts with the given IDs.| |actionids|string/array|Return only alerts generated by the given actions.| |eventids|string/array|Return only alerts generated by the given events.| |groupids|string/array|Return only alerts generated by objects from the given host groups.| |hostids|string/array|Return only alerts generated by objects from the given hosts.| |mediatypeids|string/array|Return only message alerts that used the given media types.| |objectids|string/array|Return only alerts generated by the given objects| |userids|string/array|Return only message alerts that were sent to the given users.| |eventobject|integer|Return only alerts generated by events related to objects of the given type.<br><br>See event ["object"](/manual/api/reference/event/object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |eventsource|integer|Return only alerts generated by events of the given type.<br><br>See event ["source"](/manual/api/reference/event/object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |time\_from|timestamp|Return only alerts that have been generated after the given time.| |time\_till|timestamp|Return only alerts that have been generated before the given time.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with data of hosts that triggered the action operation.| |selectMediatypes|query|Return a [mediatypes](/manual/api/reference/mediatype/object) property with an array of the media types that were used for the message alert.| |selectUsers|query|Return a [users](/manual/api/reference/user/object) property with an array of the users that the message was addressed to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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.  Aquest mètode suporta els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |alertids|string/array|Retorna només alertes amb els IDs especificats.| |actionids|string/array|Retorna només alertes generades per les accions especificades.| |eventids|string/array|Retorna només alertes generades per els events especificats.| |groupids|string/array|Retorna només alertes generades per objectes dels grups d'equips especificats.| |hostids|string/array|Retorna només alertes generades per objectes dels equips especificats.| |mediatypeids|string/array|Retorna només missatges d'alertes que empren els tipus de mitjans especificats.| |objectids|string/array|Retorna només alertes generades per els objectes especificats.| |userids|string/array|Retorna només missatges d'alertes que es van enviar als usuaris especificats.| |eventobject|integer|Retorna només alertes generades per events relacionats amb els objectes dels tipus especificats.<br><br>Veieu l'event ["object"](/manual/api/reference/event/object#event) for a list of supported object types.<br><br>Per defecte: 0 - trigger.| |eventsource|integer|Retorna només alertes generades per events del tipus especificat.<br><br>Veieu l'event ["source"](/manual/api/reference/event/object#event) per obtindre una llista dels tipus d'events suportats.<br><br>Per defecte: 0 - events de triggers.| |time\_from|timestamp|Retorna només alertes generades per després de l'hora especificada.| |time\_till|timestamp|Retorna només alertes generades abans de l'hora especificada.| |selectHosts|query|Retorna la propietat [equips](/manual/api/reference/host/object) amb informació dels equips que han executat el trigger d'operació d'acció.| |selectMediatypes|query|Retorna la propietat [mediatypes](/manual/api/reference/mediatype/object) amb una matriu dels tipus de mitjans que s'han emprat per al missatge d'alerta.| |selectUsers|query|Retorna la propietat [users](/manual/api/reference/user/object) amb una matriu dels usuaris als qui el missatge fou adreçat.| |sortfield|string/array|Ordena el resultat per les propietats especificades.<br><br>Possible values are: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto` i `status`.| |countOutput|boolean|Aquesta paràmetres són els comuns per a tots els mètodes `get`, i són descrits 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| |--|--|------| |auditids|string/array|Return only audit log with the given IDs.| |userids|string/array|Return only audit log that were created by the given users.| |time\_from|timestamp|Returns only audit log entries that have been created after or at the given time.| |time\_till|timestamp|Returns only audit log entries that have been created before or at the given time.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `auditid`, `userid`, `clock`.| |filter|object|Return only results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.| |search|object|Case insensitive sub-string search in content of fields: `username`, `ip`, `resourcename`, `details`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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  `(object)` Paràmetres definint la sortida esperada.  El mètode suporta els paràmetres següents:  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |auditids|string/array|Retorna només els registres d'auditoria amb els IDs donats.| |userids|string/array|Retorna només els registres d'auditoria creats per els usuaris donats.| |time\_from|timestamp|Retorna només els registres d'auditoria que han estat creats després de l'hora donada.| |time\_till|timestamp|Retorna només els registres d'auditoria que han estat creats abans de l'hora donada.| |sortfield|string/array|Ordena els resultats per les propietats donades.<br><br>Els valors possibles són: `auditid`, `userid`, `clock`.| |filter|object|Retorna només els resultats que concorden exactament amb el filtre donat.<br><br>Accepta una matriu, on les claus són els noms propietaris, i els valors són bé un valor senzill o una cadena de valors que concorden.<br><br>A més, suporta filtrar per detalls dels camps propietaris: `table_name`, `field_name`.| |search|object|Sub-cadena de cerca sensible a majúscules i minúcules al contingut dels camps: `username`, `ip`, `resourcename`, `details`.| |countOutput|boolean|Aquests paràmetres són comuns per a tots els mètodes `get` i es descriuen als [comentaris 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| |--|--|------| |correlationids|string/array|Return only correlations with the given IDs.| |selectFilter|query|Return a [filter](/manual/api/reference/correlation/object#correlation_filter) property with the correlation conditions.| |selectOperations|query|Return an [operations](/manual/api/reference/correlation/object#correlation_operation) property with the correlation operations.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `correlationid`, `name` and `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described 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 suporta els paràmetres següents:  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |correlationids|string/array|Retorna només les correlacions amb els IDs donats.| |selectFilter|query|Retorna una propietat de [filtre](/manual/api/reference/correlation/object#correlation_filter) amb les condicions de correlació.| |selectOperations|query|Retorna una propietat d'[operacions](/manual/api/reference/correlation/object#correlation_operation) amb les operacions de correlació.| |sortfield|string/array|Ordena el resultat per les propietats proporcionades.<br><br>Els valors possibles són: `correlationid`, `name` i `status`.| |countOutput|boolean|Aquests paràmetres, comuns per a tots els mètodes `get`, es descriuen 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| |--|--|------| |dashboardids|string/array|Return only dashboards with the given IDs.| |selectPages|query|Return a [pages](/manual/api/reference/dashboard/object#dashboard_page) property with dashboard pages, correctly ordered.| |selectUsers|query|Return a [users](/manual/api/reference/dashboard/object#dashboard_user) property with users that the dashboard is shared with.| |selectUserGroups|query|Return a [userGroups](/manual/api/reference/dashboard/object#dashboard_user_group) property with user groups that the dashboard is shared with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value is: `dashboardid`.| |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 suporta els paràmetres següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |-------|--------------------------------------------------------|-----------|dashboardids|string/array|Retorna només els taulers amb els identificadors donats.| |selectPages|query|Retorna una propietat [pàgines](/manual/api/reference/dashboard/object#dashboard_page) continguent les pàgines del tauler correctament ordenades.| |selectUsers|query|Retorna una propietat [usuaris](/manual/api/reference/dashboard/object#dashboard_user) continguent els usuaris amb els qui s'ha compartit el tauler.| |selectUserGroups|query|Retorna una propietat [userGroups](/manual/api/reference/dashboard/object#dashboard_user_group) continguent els usuaris amb els qui el tauler s'ha compartit.| |sortfield|string/array|Tria el resultat en funció de les propietats donades.<br><br>El valor possible és: `dashboardid`.| |countOutput|boolean|Aquests paràmetres comuns a tots els mètodes `get` es descriuen en detall a la pàgina de [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| |--|--|------| |dashboardids|string/array|Return only template dashboards with the given IDs.| |templateids|string/array|Return only template dashboards that belong to the given templates.| |selectPages|query|Return a [pages](/manual/api/reference/templatedashboard/object#template_dashboard_page) property with template dashboard pages, correctly ordered.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dashboardid` and `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ó| |--|--|------| |dashboardids|string/array|Retorna només plantilles de tauler de control amb els identificadors donats.| |templateids|string/array|Retorna només les plantilles de tauler que pertanyen a les plantilles especificades.| |selectPages|query|Retorna la  propietat [pàgines](/manual/api/reference/template_dashboard_page) amb pàgines de tauler de plantilles, ordenades correctament.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `dashboardid` i `name`.| |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).| |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| |--|--|------| |dcheckids|string/array|Return only discovery checks with the given IDs.| |druleids|string/array|Return only discovery checks that belong to the given discovery rules.| |dserviceids|string/array|Return only discovery checks that have detected the given discovered services.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dcheckid` and `druleid`.| |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ó| |---------|---------------------------------------- ------------|-----------| |dcheckids|string/array|Retorna només les comprovacions de descobriment amb els ID donats.| |druleids|string/array|Retorna només les comprovacions de descobriment que pertanyen a les regles de descobriment donades.| |dserviceids|string/array|Retorna només les comprovacions de descoberta que han detectat els serveis descoberts donats.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `dcheckid` i `druleid`.| |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|^| |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| |--|--|------| |dhostids|string/array|Return only discovered hosts with the given IDs.| |druleids|string/array|Return only discovered hosts that have been created by the given discovery rules.| |dserviceids|string/array|Return only discovered hosts that are running the given services.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the host.| |selectDServices|query|Return a [dservices](/manual/api/reference/dservice/object) property with the discovered services running on the host.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDServices` - results will be sorted by `dserviceid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dhostid` and `druleid`.| |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ó| |---------|---------------------------------------- ------------|-----------| |dhostids|string/array|Retorna només els equips descoberts amb els ID donats.| |druleids|string/array|Retorna només els equips descoberts creats per les regles de descobriment donades.| |dserviceids|string/array|Retorna només els equips descoberts que executen els serveis donats.| |selectDRules|query|Retorna una propietat [drules](/manual/api/reference/drule/object) que conté una matriu de regles de descobriment que van detectar l'equip.| |selectDServices|query|Retorna una propietat [dservices](/manual/api/reference/dservice/object) que conté els serveis descoberts que s'executen a l'equip.<br><br>Admet `count`.| |limitSelects|enteger|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subseleccions següents:<br>`selectDServices`: els resultats s'ordenaran per `dserviceid`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `dhostid` i `druleid`.| |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| |--|--|------| |dhostids|string/array|Return only discovery rules that created the given discovered hosts.| |druleids|string/array|Return only discovery rules with the given IDs.| |dserviceids|string/array|Return only discovery rules that created the given discovered services.| |selectDChecks|query|Return a [dchecks](/manual/api/reference/dcheck/object) property with the discovery checks used by the discovery rule.<br><br>Supports `count`.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with the discovered hosts created by the discovery rule.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectDChecks` - results will be sorted by `dcheckid`;<br>`selectDHosts` - results will be sorted by `dhostsid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `druleid` and `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ó| |--|--|------| |dhostids|string/array|Retorna només les regles de descobriment que han creat els equips descoberts donats.| |druleids|string/array|Retorna només les regles de descobriment amb els ID donats.| |dserviceids|string/array|Retorna només les regles de descoberta que han creat els serveis descoberts donats.| |selectDChecks|query|Retorna una propietat [dchecks](/manual/api/reference/dcheck/object) que conté les proves de descobriment emprades per la regla de descobriment.<br><br>Admet `count`.| |selectDHosts|query|Retorna una propietat [dhosts](/manual/api/reference/dhost/object) que conté els equips descoberts creats per la regla de descobriment.<br><br>Admet `count`.| |limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selectDChecks`: els resultats s'ordenaran per `dcheckid`;< br>`selectDHosts`: resultats s'ordenarà per `dhostsid`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `druleid` 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| |--|--|------| |discoveryids|string/array|Return only graph prototypes that belong to the given discovery rules.| |graphids|string/array|Return only graph prototypes with the given IDs.| |groupids|string/array|Return only graph prototypes that belong to hosts in the given host groups.| |hostids|string/array|Return only graph prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only graph prototypes inherited from a template.| |itemids|string/array|Return only graph prototypes that contain the given item prototypes.| |templated|boolean|If set to `true` return only graph prototypes that belong to templates.| |templateids|string/array|Return only graph prototypes that belong to the given templates.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the LLD rule that the graph prototype belongs to.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the graph items used in the graph prototype.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph prototype belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph prototype belongs to.| |selectItems|query|Return an `items` property with the [items](/manual/api/reference/item/object) and [item prototypes](/manual/api/reference/itemprototype/object) used in the graph prototype.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph prototype belongs to.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, 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 additional filters:<br>`host` - technical name of the host that the graph prototype belongs to;<br>`hostid` - ID of the host that the graph prototype belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |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  `(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ó| |--|--|------| |discoveryids|string/array|Retorna només prototips de gràfics que pertanyen a les regles de descobriment donades.| |graphids|string/array|Retorna només prototips de gràfics amb identificadors donats.| |groupids|string/array|Retorna només prototips de gràfics que pertanyen als equips dels grups d'equips donats.| |hostids|string/array|Retorna només prototips de gràfics que pertanyen als equips donats.| |inherited|boolean|Si es defineix com a `true`, només retorna els prototips de gràfics heretats d'un model.| |itemids|string/array|Retorna només prototips de gràfics que contenen els prototips d'elements donats.| |templed|boolean|Si s'estableix en `true`, només retorna prototips de gràfics que pertanyen a plantilles.| |templateids|string/array|Retorna només prototips de gràfics que pertanyen a les plantilles donades.| |selectDiscoveryRule|query|Retorna una propietat [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) amb la regla LLD a la qual pertany el prototip de gràfic.| |selectGraphItems|query|Retorna una propietat [gitems](/manual/api/reference/graphitem/object) amb els elements de gràfic emprats al prototip de gràfic.| |selectGroups|query|Retorna una propietat [groups](/manual/api/reference/hostgroup/object) amb els grups d'equips als quals pertany el prototip de gràfic.| |selectHosts|query|Retorna una propietat [hosts](/manual/api/reference/host/object) amb els equips als quals pertany el prototip de gràfic.| |selectItems|query|Retorna una propietat `items` amb els [elements](/manual/api/reference/item/object) i [prototipus d'elements](/manual/api/reference/itemprototype/object) emprats al gràfic del prototip .| |selectTemplates|query|Retorna una propietat [plantilles](/manual/api/reference/template/object) amb les plantilles a les quals pertany el prototip de gràfic.| |filter|object|Retorna només 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 el prototip de gràfic;<br>`hostid` - ID de l'equip al qual pertany el prototip de gràfic.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `graphid`, `name` i `graphtype`.| |countOutput|boolean|Com que aquests paràmetres són comuns a tots els mètodes `get`, es descriuen en detall a [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|entier|^| |output|requête|^| |preservekeys|boolean|^| |search|objet|^| |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| |--|--|------| |discoveryids|string/array|Return only item prototypes that belong to the given LLD rules.| |graphids|string/array|Return only item prototypes that are used in the given graph prototypes.| |hostids|string/array|Return only item prototypes that belong to the given hosts.| |inherited|boolean|If set to `true` return only item prototypes inherited from a template.| |itemids|string/array|Return only item prototypes with the given IDs.| |monitored|boolean|If set to `true` return only enabled item prototypes that belong to monitored hosts.| |templated|boolean|If set to `true` return only item prototypes that belong to templates.| |templateids|string/array|Return only item prototypes that belong to the given templates.| |triggerids|string/array|Return only item prototypes that are used in the given trigger prototypes.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object#lld_rule) property with the low-level discovery rule that the item prototype belongs to.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graphprototype/object#graph_prototype) property with graph prototypes that the item prototype is used in.<br><br>Supports `count`.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with an array of hosts that the item prototype belongs to.| |selectTags|query|Return the item prototype tags in [tags](/manual/api/reference/itemprototype/object#Item_prototype_tag) property.| |selectTriggers|query|Return a [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) property with trigger prototypes that the item prototype is used in.<br><br>Supports `count`.| |selectPreprocessing|query|Return a [preprocessing](/manual/api/reference/item/object#item_preprocessing) property with item preprocessing options.<br><br>It has the following properties:<br>`type` - `(string)` The preprocessing option type:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check for not supported value;<br>27- XML to JSON.<br><br>`params` - `(string)` Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n)character.<br>`error_handler` - `(string)` Action type used in case of preprocessing step failure:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>`error_handler_params` - `(string)` Error handler parameters.| |selectValueMap|query|Return a [valuemap](/manual/api/reference/valuemap/object) property with item prototype value map.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, 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 additional filters:<br>`host` - technical name of the host that the item prototype 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 are: `itemid`, `name`, `key_`, `delay`, `type` and `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  `(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ó| |--|--|------| |discoveryids|string/array|Retorna només els prototips d'elements que pertanyen a les regles de descoberta de baix nivell especificades.| |graphids|string/array|Retorna només els prototips d'elements emprats als prototips de gràfics donats.| |hostids|string/array|Retorna només els prototips d'elements que pertanyen als equips donats.| |inherited|boolean|Si s'estableix a `true`, només retorna prototips d'elements heretats d'una plantilla.| |itemids|string/array|Retorna només els prototips d'elements amb els identificadors donats.| |monitored|boolean|Si s'estableix a `true`, només retorna els prototips d'elements habilitats que pertanyen als equips monitorats.| |template|boolean|Si s'estableix a `true`, només retorna prototips d'elements amb plantilla.| |templateids|string/array|Retorna només els prototips d'elements que pertanyen a les plantilles donades.| |triggerids|string/array|Retorna només els prototips d'elements emprats als prototips de trigger donats.| |selectDiscoveryRule|query|Retorna una propietat [regla de descoberta](/manual/api/reference/discoveryrule/object#lld_rule) que conté la regla de descoberta de baix nivell que va crear el prototip d'element.| |selectGraphs|query|Retorna una propietat [gràfics](/manual/api/reference/graphprototype/object#graph_prototype) que conté els prototips de gràfics que empren el prototip d'element.<br><br>Admet `count`.| |selectHosts|query|Retorna una propietat [equips](/manual/api/reference/host/object) que conté una matriu d'equips a què pertany el prototip d'element.| |selectTags|query|Retorna les etiquetes del prototip d'element a la propietat [etiquetes](/manual/api/reference/itemprototype/object#Item_prototype_tag).| |selectTriggers|query|Retorna una propietat [triggers](/manual/api/reference/triggerprototype/object#trigger_prototype) que conté els prototips de trigger que empren aquest prototip d'element.<br><br>Admet `count`.| |selectPreprocessing|query|Retorna les opcions de preprocessament de l'element a la propietat `preprocessing`.<br><br>Té les propietats següents:<br>`type` - `(cadena)` Tipus d'opció preprocessament:<br> 1 - Multiplicador personalitzat;<br>2 - Esborrar els espais del final;<br>3 - Esborrar els espais del final;<br>4 - Esborrar els espais del final i al final;< br>5 - Coincidència d'expressió regular;<br>6 - Booleà a Decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br>9 - Canvi simple;<br>10 - Canvis per segon;<br>11 - XML ​​​​XPath;<br> 12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;<br>15 - No coincideix amb l'expressió regular;<br>16 - Troba un error en JSON;<br>17 - Troba un error en XML;<br>18 - Trobeu un error emprant una expressió regular;< br>19 - Esborra sense modificacions;<br>20 - Esborra sense modificacions amb el heartbeat;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometeu a JSON;<br>24 - CSV a JSON; <br>25 - Substituir;<br>26 - Comprovar si hi ha valors no compatibles ​​;<br>27 - XML ​​​​a JSON.<br><br>`params` - `(string)` Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats per un caràcter LF (\\n).<br>`error_handler` - `(cadena)` Tipus d'acció que s'empra en l'error del passi de preprocessament:<br>0 - El servidor Zabbix defineix el missatge d'error; <br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat. <br><br>`error_handler_params` - `(cadena)` Paràmetres del gestor d'errors.| |selectValueMap|query|Retorna una propietat [mapa de valors](/manual/api/reference/valuemap/object) que conté el mapa de valors del prototip d'element.| |filter|object|Només retorna els 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 el prototip de 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 `nom`;< br>`selectTriggers`: els resultats s'ordenaran per `descripció`.| |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|^| |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| |--|--|------| |dserviceids|string/array|Return only discovered services with the given IDs.| |dhostids|string/array|Return only discovered services that belong to the given discovered hosts.| |dcheckids|string/array|Return only discovered services that have been detected by the given discovery checks.| |druleids|string/array|Return only discovered services that have been detected by the given discovery rules.| |selectDRules|query|Return a [drules](/manual/api/reference/drule/object) property with an array of the discovery rules that detected the service.| |selectDHosts|query|Return a [dhosts](/manual/api/reference/dhost/object) property with an array the discovered hosts that the service belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts with the same IP address and proxy as the service.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectHosts` - result will be sorted by `hostid`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `dserviceid`, `dhostid` and `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).| |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àmatre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dserviceids|string/array|Retorna només els serveis descoberts amb els IDs donats.| |dhostids|string/array|Retorna només els serveis descoberts que pertanyen als equips descoberts demanats.| |dcheckids|string/array|Retorna només els serveis descoberts que han estat detectats pels tests de descoberta donats.| |druleids|string/array|Retorna només els serveis descoberts creats per les regles de descoberta donats.| |selectDRules|query|Retorna una propietat [drules](/manual/api/reference/drule/object) amb una taula de les regles de descoberta que han detectat el servei.| |selectDHosts|query|rRetorna una propietat [dhosts](/manual/api/reference/dhost/object) amb una taula dels equips descoberts als qui pertany el servei.| |selectHosts|query|Retorna una propietat [hosts](/manual/api/reference/host/object) amb els equips que tenen la mateixa adreça IP i el mateix proxy que el servei.<br><br>Admet `count`.| |limitSelects|integer|Limita el nombre d'enregistraments retornats per les sub-seleccions.<br><br>Aplica a les sub-seleccions següents:<br>`selectHosts` - el resultat s'endreçarà per `hostid`.| |sortfield|string/array|Ordena el resultat per les propietats proporcionades.<br><br>Els valors possibles són:`dserviceid`, `dhostid` i `ip`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, són descrits 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| |--|--|------| |eventids|string/array|Return only events with the given IDs.| |groupids|string/array|Return only events created by objects that belong to the given host groups.| |hostids|string/array|Return only events created by objects that belong to the given hosts.| |objectids|string/array|Return only events created by the given objects.| |source|integer|Return only events with the given type.<br><br>Refer to the [event object page](object#event) for a list of supported event types.<br><br>Default: 0 - trigger events.| |object|integer|Return only events created by objects of the given type.<br><br>Refer to the [event object page](object#event) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|If set to `true` return only acknowledged events.| |suppressed|boolean|`true` - return only suppressed events;<br>`false` - return events in the normal state.| |severities|integer/array|Return only events with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only events with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all events.<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.| |eventid\_from|string|Return only events with IDs greater or equal to the given ID.| |eventid\_till|string|Return only events with IDs less or equal to the given ID.| |time\_from|timestamp|Return only events that have been created after or at the given time.| |time\_till|timestamp|Return only events that have been created before or at the given time.| |problem\_time\_from|timestamp|Returns only events that were in the problem state starting with `problem_time_from`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_till` is specified.| |problem\_time\_till|timestamp|Returns only events that were in the problem state until `problem_time_till`. Applies only if the source is trigger event and object is trigger. Mandatory if `problem_time_from` is specified.| |value|integer/array|Return only events with the given values.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts containing the object that created the event. Supported only for events generated by triggers, items or LLD rules.| |selectRelatedObject|query|Return a `relatedObject` property with the object that created the event. The type of object returned depends on the event type.| |select\_alerts|query|Return an [alerts](/manual/api/reference/alert/object) property with alerts generated by the event. Alerts are sorted in reverse chronological order.| |select\_acknowledges|query|Return an `acknowledges` property with event updates. Event updates are sorted in reverse chronological order.<br><br>The event update object has the following properties:<br>`acknowledgeid` - `(string)` acknowledgment's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)` update action that was performed see [event.acknowledge](/manual/api/reference/event/acknowledge);<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br>`username` - `(string)` username of the user that updated the event;<br>`name` - `(string)` name of the user that updated the event;<br>`surname` - `(string)` surname of the user that updated the event.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/event/object#Event_tag) property with event tags.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`, `objectid` and `clock`.| |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|Descripció| |-----------|----|------------| |eventids|string/array|Retorna només esdeveniments amb els identificadors donats.| |groupids|string/array|Retorna només esdeveniments creats per objectes que pertanyen als grups d'equips donats.| |hostids|string/array|Retorna només els esdeveniments creats per objectes que pertanyen als equips donats.| |objectids|string/array|Retorna només els esdeveniments creats pels objectes donats.| |source|integer|Retorna només esdeveniments amb el tipus donat.<br><br>Consulteu la [pàgina d'objectes d'esdeveniment](/en/manual/api/reference/event/object#event) per obtindre una llista dels tipus d'esdeveniments compatibles .<br><br>Per defecte: 0 - desencadena esdeveniments.| |object|integer|Retorna només els esdeveniments creats per objectes del tipus donat.<br><br>Consulteu a [Pàgina d'objectes d'esdeveniment](/en/manual/api/reference/event/object#evenement ) per obtindre una llista dels admesos. tipus d'esdeveniment.<br><br>Per defecte: 0 - trigger.| |acknowledged|boolean|Si es defineix com a `true`, només retorna els esdeveniments reconeguts.| |suppressed|boolean|`true` - Retorna només esdeveniments suprimits;<br>`false` - Retorna només esdeveniments suprimits amb un estat normal.| |severities|integer/array|Retorna només esdeveniments amb gravetats donades. S'aplica només si l'objecte és un trigger.| |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 object|Retorna només esdeveniments amb etiquetes donades. Concordança exacta per etiqueta i cerca sense distinció entre majúscules i minúscules per valor i operador.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Una matriu buida retorna tots els esdeveniments.<br><br>Tipus d'operadors possibles:<br>0 - (per defecte) Com;<br>1 - Igual;<br>2 - No és com;<br>3 - No és igual<br>4 - Existeix;<br>5 - No existeix.| |eventid\_from|string|Retorna només esdeveniments l'identificador dels quals és superior o igual a l'identificador donat.| |eventid\_till|string|Retorna només esdeveniments l'identificador dels quals és menor o igual que l'identificador donat.| |time\_from|timestamp|Retorna només els esdeveniments creats després o a l'hora especificada.| |time\_till|timestamp|Retorna només els esdeveniments creats abans o a l'hora especificada.| |problem\_time\_from|timestamp|Retorna només els esdeveniments que eren en estat de problema des de `problem_time_from`. S'aplica només si la font és un esdeveniment trigger i l'objecte és un trigger. Obligatori si s'especifica `problem_time_till`.| |problem\_time\_till|timestamp|Retorna només els esdeveniments que eren en estat de problema fins a `problem_time_till`. S'aplica només si la font és un esdeveniment trigger i l'objecte és un trigger. Obligatori si s'especifica `problem_time_from`.| |value|integer/array|Retorna només esdeveniments amb els valors donats.| |selectHosts|query|Retorna una propietat [hosts](/manual/api/reference/host/object) amb els equips que contenen l'objecte que va crear l'esdeveniment. Només s'admet per a esdeveniments generats per triggers, elements o regles de descobriment de baix nivell.| |selectRelatedObject|query|Retorna una propietat `relatedObject amb l'objecte que va crear l'esdeveniment a la propietat`. El tipus d'objecte retornat depèn del tipus d'esdeveniment.| |select\_alerts|query|Retorna una propietat [alerts](/manual/api/reference/alert/object) amb alertes generades per l'esdeveniment. Les alertes s'ordenen en ordre cronològic invers.| |select\_acknowledges|query|Retorna una propietat `acknowledges` de les actualitzacions d'esdeveniments. Les actualitzacions d'esdeveniments s'ordenen en ordre cronològic invers.<br><br>L'objecte d'actualització d'esdeveniments té les propietats següents:<br>`acknowledgeid` - `(string)` ID del reconeixement;<br>`identificador d'usuari` - `(string)` ID de l'usuari que va actualitzar l'esdeveniment ;<br>`eventid` - `(string)` ID del dia actualitzat de l'esdeveniment;<br>`clock` - `(timestamp)` hora d'actualització de l'esdeveniment;<br> `missatge` - `(string)` text del missatge;<br>`acció` - `(integer)` acció d'actualització realitzada, vegeu [event.acknowledge](/manual/api/reference/event/acknowledge);< br>`old_severity` - `(integer)` gravetat de l'esdeveniment abans d'aquesta acció d'actualització;<br>`new_severity` - `(integer)` gravetat de l'esdeveniment després d'aquesta acció d'actualització;<br>`username` - `(string)` nom d'usuari de l'usuari que ha actualitzat l'esdeveniment ;<br>`nom` - `(string)` nom de l'usuari qui ha actualitzat l'esdeveniment ;<br>`cognom` - `(string)` cognom de l'usuari qui ha actualitzat l'esdeveniment.<br><br>Admet `count`.| |selectTags|query|Retorna una propietat [etiquetes](/manual/api/reference/event/object#Event_tag) amb etiquetes d'esdeveniment.| |selectSuppressionData|query|Retorna una propietat `suppression_data` amb la llista de manteniments:<br>`maintenanceid` - `(string)` ID de manteniment;<br>`suppress_until` - `(integer)` temps abans que s'esborri l'esdeveniment de manteniment. | |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `eventid`, `objectid` i `clock`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes "get", es descriuen a [reference comments](/fr/manual/api/reference_commentary#Common_parameters_of_the_get_method).| |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| |--|--|------| |eventids|string/array|Return only problems with the given IDs.| |groupids|string/array|Return only problems created by objects that belong to the given host groups.| |hostids|string/array|Return only problems created by objects that belong to the given hosts.| |objectids|string/array|Return only problems created by the given objects.| |source|integer|Return only problems with the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported event types.<br><br>Default: 0 - problem created by a trigger.| |object|integer|Return only problems created by objects of the given type.<br><br>Refer to the [problem event object page](object#problem) for a list of supported object types.<br><br>Default: 0 - trigger.| |acknowledged|boolean|`true` - return acknowledged problems only;<br>`false` - unacknowledged only.| |suppressed|boolean|`true` - return only suppressed problems;<br>`false` - return problems in the normal state.| |severities|integer/array|Return only problems with given event severities. Applies only if object is trigger.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only problems with given tags. Exact match by tag and case-insensitive search by value and operator.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>An empty array returns all problems.<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.| |recent|boolean|`true` - return PROBLEM and recently RESOLVED problems (depends on Display OK triggers for N seconds)<br>Default: `false` - UNRESOLVED problems only| |eventid\_from|string|Return only problems with IDs greater or equal to the given ID.| |eventid\_till|string|Return only problems with IDs less or equal to the given ID.| |time\_from|timestamp|Return only problems that have been created after or at the given time.| |time\_till|timestamp|Return only problems that have been created before or at the given time.| |selectAcknowledges|query|Return an `acknowledges` property with the problem updates. Problem updates are sorted in reverse chronological order.<br><br>The problem update object has the following properties:<br>`acknowledgeid` - `(string)` update's ID;<br>`userid` - `(string)` ID of the user that updated the event;<br>`eventid` - `(string)` ID of the updated event;<br>`clock` - `(timestamp)` time when the event was updated;<br>`message` - `(string)` text of the message;<br>`action` - `(integer)`type of update action (see [event.acknowledge](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` event severity before this update action;<br>`new_severity` - `(integer)` event severity after this update action;<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/problem/object#problem_tag) property with the problem tags. Output format: `[{"tag": "<tag>", "value": "<value>"}, ...]`.| |selectSuppressionData|query|Return a `suppression_data` property with the list of maintenances:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`suppress_until` - `(integer)` time until the problem is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `eventid`.| |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ó| |--|--|------| |eventids|string/array|Retorna només problemes amb els ID donats.| |groupids|string/array|Retorna només problemes creats per objectes que pertanyen als grups d'equips donats.| |hostids|string/array|Retorna només problemes creats per objectes propietat dels equips donats.| |objectids|string/array|Retorna només els problemes creats pels objectes donats.| |source|integer|Només retorna problemes amb el tipus donat.<br><br>Consulteu la [pàgina de l'objecte d'esdeveniment del problema](objecte#problem) per obtindre una llista dels tipus d'esdeveniments admesos.<br><br>Per defecte: 0 - problema creat per un trigger.| |object|integer|Només retorna problemes creats per objectes del tipus donat.<br><br>Consulteu la [pàgina d'objectes d'esdeveniment de problema](objecte#problema) per obtindre una llista dels tipus d'objectes admesos.<br><br> Per defecte: 0 - trigger.| |acknowledged|boolean|`true`: només retorna problemes reconeguts;<br>`false`: només problemes no reconeguts.| |suppressed|boolean|`true`: només retorna problemes esborrats;<br>`false`: retorna problemes en estat normal.| |severities|integer/array|Retorna només problemes amb la gravetat dels esdeveniments determinada. S'aplica només si l'objecte és un trigger.| |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 problemes amb les etiquetes donades. Concordança exacta per etiqueta i cerca sense distinció entre majúscules i minúscules per valor i operador.<br>Format: `[{"tag": "<etiqueta>", "value": "<valor>", "operator": "<operador > "}, ...]`.<br>Una matriu buida retorna tots els problemes.<br><br>Tipus d'operadors possibles:<br>0 - (per defecte) És com;<br>1 - És igual a ;<br>2 - No és com;<br>3 - No és igual< br>4 - Existeix;<br>5 - No existeix.| |recent|boolean|`true`: retorna PROBLEMA i problemes RESOLTS recentment (depèn de mostrar triggers correctes durant N segons)<br>Per defecte: `false` - només problemes NO RESOLTS| |eventid\_from|string|Retorna només problemes amb ID superiors o iguals a l'ID donat.| |eventid\_till|string|Retorna només problemes amb ID inferiors o iguals a l'ID donat.| |time\_from|timestamp|Retorna només els problemes que es van crear després o en el moment donat.| |time\_till|timestamp|Retorna només els problemes que s'han creat abans o en el moment donat.| |selectAcknowledges|query|Retorna una propietat "acknowledges" amb actualitzacions de problemes. Les actualitzacions de problemes s'ordenen en ordre cronològic invers.<br><br>L'objecte d'actualització de problemes té les propietats següents:<br>`acknowledgeid` - `(cadena)` ID de l'actualització;<br>`identificador d'usuari` - `( string)` ID de l'usuari que ha actualitzat l'esdeveniment;<br>`eventid` - `(cadena)` ID de l'esdeveniment actualitzat;<br>`clock` - `(timestamp)` hora en què s'ha actualitzat l'esdeveniment;<br > `missatge` - `(cadena)` text del missatge;<br>`acció` - `(enter)`actualitza el tipus d'acció (vegeu [event.acknowledge](/manual/api/reference/event/acknowledge));< br>`old_severity`: gravetat de l'esdeveniment `(integer)` abans d'aquesta acció d'actualització;<br>`new_severity` - gravetat de l'esdeveniment `(integer)` després d'aquesta acció d'actualització;<br><br>Admet `count`.| |selectTags|query|Retorna una propietat [etiquetes](/manual/api/reference/problem/object#problem_tag) amb les etiquetes del problema. Format de sortida:`[{"tag": "<etiqueta>", "value": "<valor>"}, ...]`.| |selectSuppressionData|query|Retorna una propietat `suppression_data` amb la llista de manteniments:<br>`maintenanceid` - `(cadena)` ID de manteniment;<br>`suppress_until` - `(integer)` temps fins que s'esborra el problema.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `eventid`.| |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).| |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| |--|--|------| |globalmacro|flag|Return global macros instead of host macros.| |globalmacroids|string/array|Return only global macros with the given IDs.| |groupids|string/array|Return only host macros that belong to hosts or templates from the given host groups.| |hostids|string/array|Return only macros that belong to the given hosts or templates.| |hostmacroids|string/array|Return only host macros with the given IDs.| |inherited|boolean|If set to `true` return only host prototype user macros inherited from a template.| |selectGroups|query|Return host groups that the host macro belongs to in the [groups](/manual/api/reference/hostgroup/object) property.<br><br>Used only when retrieving host macros.| |selectHosts|query|Return hosts that the host macro belongs to in the [hosts](/manual/api/reference/host/object) property.<br><br>Used only when retrieving host macros.| |selectTemplates|query|Return templates that the host macro belongs to in the [templates](/manual/api/reference/template/object) property.<br><br>Used only when retrieving host macros.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible value: `macro`.| |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ó| |--|--|------| |globalmacro|flag|Retorna macros globals en lloc de macros d'equips.| |globalmacroids|string/array|Retorna només macros globals amb els ID donats.| |groupids|string/array|Retorna només macros d'equips que pertanyen als equips o plantilles dels grups d'equips donats.| |hostids|string/array|Retorna només macros que pertanyen als equips o plantilles donades.| |hostmacroids|string/array|Retorna només macros de l'equip amb els ID donats.| |inherited|boolean|Si s'estableix a "true", només retorna les macros d'usuari prototip d'equips heretades d'una plantilla.| |selectGroups|query|Retorna els grups d'equips als quals pertany la macro de l'equip a la propietat [grups](/manual/api/reference/hostgroup/object).<br><br>Només s'empra per recuperar macros d'equips.| |selectHosts|query|Retorna els equips als quals pertany la macro de l'equip a la propietat [equips](/manual/api/reference/host/object).<br><br>Només s'empra per recuperar macros d'equips.| |selectTemplates|query|Retorna les plantilles a les quals pertany la macro de l'equip a la propietat [plantilles](/manual/api/reference/template/object).<br><br>Només s'empra per recuperar macros de l'equip.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Valor possible: `macro`.| |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|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphids|string/array|Return only graph items that belong to the given graphs.| |itemids|string/array|Return only graph items with the given item IDs.| |type|integer|Return only graph items with the given type.<br><br>Refer to the [graph item object page](object#graph_item) for a list of supported graph item types.| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with an array of graphs that the item belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `gitemid`.| |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|^| |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|Descripció| |-----------|----|------------| |graphids|string/array|Retorna només els elements de gràfic que pertanyen als gràfics donats.| |itemids|string/array|Retorna només els elements del gràfic amb els ID d'elements donats.| |type|integer|Retorna només els elements del gràfic amb el tipus donat.<br><br>Consulteu la [pàgina d'objectes d'elements de gràfic](/manual/api/reference/graphitem/object# chart_element) per obtindre una llista dels gràfics compatibles amb els tipus d'elements.| |selectGraphs|query|Retorna una propietat [gràfics](/manual/api/reference/graph/object) que conté una matriu de gràfics a què pertany l'element.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `gitemid`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes "get", es descriuen a [reference comments](/manual/api/reference_commentary#Common_parameters_of_the_get_method).| |editable|boolean|^| |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| |--|--|------| |graphids|string/array|Return only graphs with the given IDs.| |groupids|string/array|Return only graphs that belong to hosts in the given host groups.| |templateids|string/array|Return only graph that belong to the given templates.| |hostids|string/array|Return only graphs that belong to the given hosts.| |itemids|string/array|Return only graphs that contain the given items.| |templated|boolean|If set to `true` return only graphs that belong to templates.| |inherited|boolean|If set to `true` return only graphs inherited from a template.| |expandName|flag|Expand macros in the graph name.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that the graph belongs to.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that the graph belongs to.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with the items used in the graph.| |selectGraphDiscovery|query|Return a `graphDiscovery` property with the graph discovery object. The graph discovery objects links the graph to a graph prototype from which it was created.<br><br>It has the following properties:<br>`graphid` - `(string)` ID of the graph;<br>`parent_graphid` - `(string)` ID of the graph prototype from which the graph has been created.| |selectGraphItems|query|Return a [gitems](/manual/api/reference/graphitem/object) property with the items used in the graph.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the low-level discovery rule that created the graph.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, 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 additional filters:<br>`host` - technical name of the host that the graph belongs to;<br>`hostid` - ID of the host that the graph belongs to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `graphid`, `name` and `graphtype`.| |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	### 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ó| |--|--|------| |graphids|string/array|Retorna només gràfics amb els identificadors donats.| |groupids|string/array|Retorna només gràfics que pertanyen als equips dels grups d'equips donats.| |templateids|string/array|Retorna només gràfics que pertanyen a les plantilles donades.| |hostids|string/array|Retorna només gràfics que pertanyen als equips donats.| |itemids|string/array|Retorna només gràfics que contenen els elements donats.| |template|boolean|Si s'estableix com a `true`, retorna només gràfics amb plantilla.| |inherited|booleà|Si és cert, retorna només els gràfics heretats d'un model.| |expandName|flag|Amplieu les macros al nom del gràfic.| |selectGroups|query|Retorna la propietat [grups](/manual/api/reference/hostgroup/object) amb els grups d'equip als quals pertany el gràfic.| |selectTemplates|query|Retorna la propietat [plantilles](/manual/api/reference/template/object) amb les plantilles a les quals pertany el gràfic.| |selectHosts|query|Retorna la propietat [equips](/manual/api/reference/host/object) amb els equips als quals pertany el gràfic.| |selectItems|query|Retorna la propietat [elements](/manual/api/reference/item/object) amb els elements emprats al gràfic.| |selectGraphDiscovery|query|Retorna la propietat `graphDiscovery` que conté l'objecte de descobriment de gràfics. Els objectes de descobriment de gràfics enllacen el gràfic amb un prototip de gràfic a partir del que es va crear.<br><br>Té les propietats següents:<br>`graphid` - `(cadena)` ID de gràfic; <br>`parent_graphid` - `(cadena)` ID del prototip de gràfic a partir del qual es va crear el gràfic.| |selectGraphItems|query|Retorna la propietat [gitems](/manual/api/reference/graphitem/object) amb els elements emprats al gràfic.| |selectDiscoveryRule|query|Retorna la propietat [discoveryRule](/manual/api/reference/drule/object) amb la regla de descoberta de baix nivell que va crear el gràfic.| |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 el gràfic;<br>`hostid` - ID de l'equip al qual pertany el gràfic.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `graphid`, `name` i `graphtype`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes "get", es descriuen a [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| |--|--|------| |graphids|string/array|Return only host groups that contain hosts or templates with the given graphs.| |groupids|string/array|Return only host groups with the given host group IDs.| |hostids|string/array|Return only host groups that contain the given hosts.| |maintenanceids|string/array|Return only host groups that are affected by the given maintenances.| |monitored\_hosts|flag|Return only host groups that contain monitored hosts.| |real\_hosts|flag|Return only host groups that contain hosts.| |templated\_hosts|flag|Return only host groups that contain templates.| |templateids|string/array|Return only host groups that contain the given templates.| |triggerids|string/array|Return only host groups that contain hosts or templates with the given triggers.| |with\_graphs|flag|Return only host groups that contain hosts with graphs.| |with\_graph\_prototypes|flag|Return only host groups that contain hosts with graph prototypes.| |with\_hosts\_and\_templates|flag|Return only host groups that contain hosts *or* templates.| |with\_httptests|flag|Return only host groups that contain hosts with web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_items|flag|Return only host groups that contain hosts or templates with items.<br><br>Overrides the `with_monitored_items` and `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only host groups that contain hosts with item prototypes, which are enabled for creation and have numeric type of information.| |with\_monitored\_httptests|flag|Return only host groups that contain hosts with enabled web checks.| |with\_monitored\_items|flag|Return only host groups that contain hosts or templates with enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only host groups that contain hosts with enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only host groups that contain hosts with numeric items.| |with\_triggers|flag|Return only host groups that contain hosts with triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/drule/object) property with the LLD rule that created the host group.| |selectGroupDiscovery|query|Return a `groupDiscovery` property with the host group discovery object.<br><br>The host group discovery object links a discovered host group to a host group prototype and has the following properties:<br>`groupid` - `(string)` ID of the discovered host group;<br>`lastcheck` - `(timestamp)` time when the host group was last discovered;<br>`name` - `(string)` name of the host group prototype;<br>`parent_group_prototypeid` - `(string)` ID of the host group prototype from which the host group has been created;<br>`ts_delete` - `(timestamp)` time when a host group that is no longer discovered will be deleted.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts that belong to the host group.<br><br>Supports `count`.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that belong to the host group.<br><br>Supports `count`.| |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`;<br>`selectTemplates` - results will be sorted by `host`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `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) 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 definint la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphids|string/array|Retorna només grups d'equips que contenen equips o patrons amb els gràfics donats.| |groupids|string/array|Retorna només els grups d'equips amb els ID de grup d'equips donats.| |hostids|string/array|Retorna només els grups d'equips que contenen els equips donats.| |maintenanceids|string/array|Retorna només els grups d'equips afectats pels manteniments donats.| |monitored\_hosts|flag|Retorna només grups d'equips que contenen equips supervisats.| |real\_hosts|flag|Retorna només grups d'equips que contenen equips.| |template\_hosts|flag|Retorna només grups d'equips que contenen plantilles.| |templateids|string/array|Retorna només els grups d'equips que contenen les plantilles donades.| |triggerids|string/array|Retorna només grups d'equips que contenen equips o patrons amb els triggers donats.| |with\_graphs|flag|Retorna només grups d'equips que contenen equips amb gràfics.| |with\_graph\_prototypes|flag|Retorna només grups d'equips que contenen equips amb prototips de gràfics.| |with\_hosts\_and\_templates|flag|Retorna només grups d'equips que contenen plantilles *o*.| |with\_httptests|flag|Retorna només grups d'equips que contenen equips amb comprovacions web.<br><br>Anul·la la configuració `with_monitored_httptests`.| |with\_items|flag|Retorna només grups d'equips que contenen equips o plantilles amb elements.<br><br>Substitueix la configuració `with_monitored_items` i `with_simple_graph_items`.| |with\_item\_prototypes|flag|Retorna només grups d'equips que contenen equips o plantilles amb prototips d'elements.<br><br>Anul·la el paràmetre `with_simple_graph_item_prototypes`.| |with\_simple\_graph\_item\_prototypes|marcador|Retorna només grups d'equips que contenen equips amb prototips d'elements, activats en crear-los i amb informació de tipus numèric.| |with\_monitored\_httptests|flag|Retorna només grups d'equips que contenen equips amb monitors web activats.| |with\_monitored\_items|flag|Retorna només grups d'equips que contenen equips o plantilles amb elements activats.<br><br>Anul·la la configuració `with_simple_graph_items`.| |with\_monitored\_triggers|flag|Retorna només grups d'equips que contenen equips amb triggers activats. També s'han d'activar tots els elements emprats al trigger.| |with\_simple\_graph\_items|flag|Retorna només grups d'equips que contenen equips amb elements numèrics.| |with\_triggers|flag|Retorna només grups d'equips que contenen equips amb triggers.<br><br>Anul·la la configuració `with_monitored_triggers`.| |selectDiscoveryRule|query|Retorna una propietat [discoveryRule](/manual/api/reference/drule/object) que conté la regla de descobriment de baix nivell que va crear el grup d'equips.| |selectGroupDiscovery|query|Retorna la propietat `groupDiscovery` que conté l'objecte de descobriment del grup d'equips.<br><br>L'objecte de descobriment del grup d'equips enllaça un grup d'equips descobert a un grup d'equips prototip i té les propietats següents:<br>`groupid` - `(cadena)` identificador del grup d'equips descobert;<br>`última comprovació` - `(marca de temps)` el darrer grup de temps descobert 'equips;<br>`nom` - `(cadena)` nom del prototip del grup d'equips;< br>`parent_group_prototypeid` - `(cadena)` ID del prototip del grup d'equips a partir del qual es va crear l'equip;<br>`ts_delete' - `(marca de temps)` hora en què un grup d'equips que ja no es descobreix s'esborrarà.| |selectHosts|query|Retorna una propietat [equips](/manual/api/reference/host/object) que conté els equips que pertanyen al grup d'equips.<br><br>Admet `count`.| |selectTemplates|query|Retorna una propietat [plantilles](/manual/api/reference/template/object) que conté les plantilles que pertanyen al grup d'equips.<br><br>Admet `count`.| |limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selectHosts`: els resultats s'ordenaran per `host`;< br>`selectTemplates` - els resultats s'ordenaran per `host`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `groupid`, `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| |--|--|------| |groupids|string/array|Return only hosts that belong to the given groups.| |dserviceids|string/array|Return only hosts that are related to the given discovered services.| |graphids|string/array|Return only hosts that have the given graphs.| |hostids|string/array|Return only hosts with the given host IDs.| |httptestids|string/array|Return only hosts that have the given web checks.| |interfaceids|string/array|Return only hosts that use the given interfaces.| |itemids|string/array|Return only hosts that have the given items.| |maintenanceids|string/array|Return only hosts that are affected by the given maintenances.| |monitored\_hosts|flag|Return only monitored hosts.| |proxy\_hosts|flag|Return only proxies.| |proxyids|string/array|Return only hosts that are monitored by the given proxies.| |templated\_hosts|flag|Return both hosts and templates.| |templateids|string/array|Return only hosts that are linked to the given templates.| |triggerids|string/array|Return only hosts that have the given triggers.| |with\_items|flag|Return only hosts that have items.<br><br>Overrides the `with_monitored_items` and `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only hosts that have item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only hosts that have item prototypes, which are enabled for creation and have numeric type of information.| |with\_graphs|flag|Return only hosts that have graphs.| |with\_graph\_prototypes|flag|Return only hosts that have graph prototypes.| |with\_httptests|flag|Return only hosts that have web checks.<br><br>Overrides the `with_monitored_httptests` parameter.| |with\_monitored\_httptests|flag|Return only hosts that have enabled web checks.| |with\_monitored\_items|flag|Return only hosts that have enabled items.<br><br>Overrides the `with_simple_graph_items` parameter.| |with\_monitored\_triggers|flag|Return only hosts that have enabled triggers. All of the items used in the trigger must also be enabled.| |with\_simple\_graph\_items|flag|Return only hosts that have items with numeric type of information.| |with\_triggers|flag|Return only hosts that have triggers.<br><br>Overrides the `with_monitored_triggers` parameter.| |withProblemsSuppressed|boolean|Return hosts that have suppressed problems.<br><br>Possible values:<br>`null` - (default) all hosts;<br>`true` - only hosts with suppressed problems;<br>`false` - only hosts with unsuppressed problems.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |severities|integer/array|Return hosts that have only problems with given severities. Applies only if problem object is trigger.| |tags|object/array|Return only hosts 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 hosts.<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.| |inheritedTags|boolean|Return hosts that have given `tags` also in all of their linked templates. Default:<br><br>Possible values:<br>`true` - linked templates must also have given `tags`;<br>`false` - (default) linked template tags are ignored.| |selectDiscoveries|query|Return a [discoveries](/manual/api/reference/discoveryrule/object) property with host low-level discovery rules.<br><br>Supports `count`.| |selectDiscoveryRule|query|Return a [discoveryRule](/manual/api/reference/discoveryrule/object) property with the low-level discovery rule that created the host (from host prototype in VMware monitoring).| |selectGraphs|query|Return a [graphs](/manual/api/reference/graph/object) property with host graphs.<br><br>Supports `count`.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups data that the host belongs to.| |selectHostDiscovery|query|Return a `hostDiscovery` property with host discovery object data.<br><br>The host discovery object links a discovered host to a host prototype or a host prototypes to an LLD rule and has the following properties:<br>`host` - *(string)* host of the host prototype;<br>`hostid` - *(string)* ID of the discovered host or host prototype;<br>`parent_hostid` - *(string)* ID of the host prototype from which the host has been created;<br>`parent_itemid` - *(string)* ID of the LLD rule that created the discovered host;<br>`lastcheck` - *(timestamp)* time when the host was last discovered;<br>`ts_delete` - *(timestamp)* time when a host that is no longer discovered will be deleted.| |selectHttpTests|query|Return an [httpTests](/manual/api/reference/httptest/object) property with host web scenarios.<br><br>Supports `count`.| |selectInterfaces|query|Return an [interfaces](/manual/api/reference/hostinterface/object) property with host interfaces.<br><br>Supports `count`.| |selectInventory|query|Return an [inventory](/manual/api/reference/host/object#host_inventory) property with host inventory data.| |selectItems|query|Return an [items](/manual/api/reference/item/object) property with host items.<br><br>Supports `count`.| |selectMacros|query|Return a [macros](/manual/api/reference/usermacro/object) property with host macros.| |selectParentTemplates|query|Return a [parentTemplates](/manual/api/reference/template/object) property with templates that the host is linked to.<br><br>Supports `count`.| |selectDashboards|query|Return a [dashboards](/manual/api/reference/templatedashboard/object) property.<br><br>Supports `count`.| |selectTags|query|Return a [tags](/manual/api/reference/host/object#host_tag) property with host tags.| |selectInheritedTags|query|Return an [inheritedTags](/manual/api/reference/host/object#host_tag) property with tags that are on all templates which are linked to host.| |selectTriggers|query|Return a [triggers](/manual/api/reference/trigger/object) property with host triggers.<br><br>Supports `count`.| |selectValueMaps|query|Return a [valuemaps](/manual/api/reference/valuemap/object) property with host value maps.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by interface properties. Doesn't work for `text` fields.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectParentTemplates` - results will be sorted by `host`;<br>`selectInterfaces`;<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`.| |search|object|Return results that match the given pattern (case-insensitive).<br><br>Accepts an array, 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>Allows searching by interface properties. Works only for `string` and `text` fields.| |searchInventory|object|Return only hosts that have inventory data matching the given wildcard search.<br><br>This parameter is affected by the same additional parameters as `search`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `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|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(object)` Paràmetres definit la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupids|string/array|Retorna només els equips que pertanyen als grups donats.| |dserviceids|string/array|Retorna només els equips associats amb els serveis descoberts donats.| |graphids|string/array|Retorna només els equips que tenen els gràfics indicats.| |hostids|string/array|Retorna només els equips amb els ID d'equip donats.| |httptestids|string/array|Retorna només els equips amb els monitors web indicats.| |interfaceids|string/array|Retorna només els equips que empren les interfícies donades.| |itemids|string/array|Retorna només els equips amb els elements donats.| |maintenanceids|string/array|Retorna només els equips afectats pels manteniments donats.| |monitored\_hosts|mark|Retorna només els equips supervisats.| |proxy\_hosts|mark|Només retorna proxys.| |proxyids|string/array|Retorna només els equips supervisats pels proxys donats.| |templated\_hosts|flag|Retorna equips i plantilles.| |templateids|string/array|Retorna només els equips vinculats a les plantilles donades.| |triggerids|string/array|Retorna només els equips amb els triggers donats.| |with\_items|flag|Retorna només els equips que tenen elements.<br><br>Substitueix els paràmetres `with_monitored_items` i `with_simple_graph_items`.| |with\_item\_prototypes|mark|Retorna només els equips que tenen prototipus d'elements.<br><br>Anul·la el paràmetre `with_simple_graph_item_prototypes`.| |with\_simple\_graph\_item\_prototypes|marcador|Retorna només els equips que tenen prototipus d'elements, són habilitats per a la creació i tenen informació de tipus numèric.| |with\_graphs|flag|Retorna només equips amb gràfics.| |with\_graph\_prototypes|mark|Retorna només els equips amb prototips de gràfics.| |with\_httptests|mark|Retorna només equips amb supervisió web.<br><br>Anul·la la configuració `with_monitored_httptests`.| |with\_monitored\_httptests|mark|Retorna només equips amb monitors web actius.| |with\_monitored\_items|mark|Retorna només els equips amb elements actius.<br><br>Anul·la la configuració `with_simple_graph_items`.| |with\_monitored\_triggers|mark|Retorna només els equips amb triggers actius. També s'han d'activar tots els elements emprats al trigger.| |with\_simple\_graph\_items|mark|Retorna només els equips amb elements que contenen informació de tipus numèric.| |with\_triggers|flag|Retorna només els equips amb triggers.<br><br>Anul·la la configuració `with_monitored_triggers`.| |withProblemsSuppressed|boolean|Retorna els equips amb problemes esborrats.<br><br>Valors possibles:<br>`null` - (per defecte) tots els equips;<br>`true`: només els equips amb problemes eborrats;<br >`false`: només els equips amb problemes no esborrats.| |evaltype|integer|Regles de cerca d'etiquetes.<br><br>Valors possibles:<br>0 - (per defecte) i/o;<br>2 - O.| |severities|integer/array|Retorna els equips que només tenen problemes amb una gravetat determinada. S'aplica només si l'objecte problemàtic és un trigger.| |tags|array/object|Retorna només els equips amb etiquetes donades. Concordança exacta per etiqueta i cerca entre majúscules i minúscules o no per valor d'etiqueta en funció del valor de l'operador.<br>Format: `[{"tag": "<etiqueta>", "value": "< valor>", "operator": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els equips.<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.| |inheritedTags|boolean|Retorna els equips que tenen `etiquetes` donades així com en totes les seves plantilles enllaçades. Valors per defecte:<br><br>Possibles valors:<br>`true`: els models enllaçats també han de tenir les `etiquetes`;<br>`false`: les etiquetes de models enllaçats (per defecte) s'ignoren. |selectDiscoveries|query|Retorna una propietat [descobertes](/manual/api/reference/discoveryrule/object) que conté regles de descoberta de baix nivell.<br><br>Admet `count`.| |selectDiscoveryRule|query|Retorna una propietat [discoveryRule](/manual/api/reference/discoveryrule/object) amb la regla de descoberta de baix nivell que va crear l'equip (a partir del prototip d'equip a la supervisió de VMware).| |selectGraphs|query|Retorna una propietat [gràfics](/manual/api/reference/graph/object) amb gràfics de l'equip.<br><br>Admet `count`.| |selectGroups|query|Retorna una propietat [grups](/manual/api/reference/hostgroup/object) amb els grups d'equip als quals pertany l'equip.| |selectHostDiscovery|query|Retorna una propietat `hostDiscovery` amb dades de l'objecte de descoberta de l'equip.<br><br>L'objecte de descoberta de l'equip enllaça un equip descobert a un prototip o un prototip d'equips a una regla de descoberta de baix nivell i té les propietats següents:<br>`host` - *(cadena)* equip de l'equip prototip;<br>`hostid` - *(cadena)* Id de l'equip descobert o equip prototip;<br >`parent_hostid` - *( string)* ID del prototip d'equip a partir del qual es va crear l'equip;<br>`parent_itemid` - *(cadena)* ID de la regla de descoberta de baix nivell que va crear l'equip descobert;<br>`darrera comprovació` - *(timestamp)* hora en què es va descobrir l'equip per darrera vegada;<br>`ts_delete` - *(timestamp)* hora en què s'eliminarà un equip que ja no es descobreix.| |selectHttpTests|query|Retorna una propietat [httpTests](/manual/api/reference/httptest/object) amb escenaris web d'equip.<br><br>Admet `count`.| |selectInterfaces|query|Retorna una propietat [interfícies](/manual/api/reference/hostinterface/object) amb interfícies d'equip.<br><br>Admet `count`.| |selectInventory|query|Retorna una propietat [inventari](/manual/api/reference/host/object#host_inventory) amb dades d'inventari de l'equip.| |selectItems|query|Retorna una propietat [elements](/manual/api/reference/item/object) amb elements de l'equip.<br><br>Admet `count`.| |selectMacros|query|Retorna una propietat de [macros](/manual/api/reference/usermacro/object) amb macros de l'equip.| |selectParentTemplates|query|Retorna una propietat [parentTemplates](/manual/api/reference/template/object) amb les plantilles a les quals està vinculat l'equip.<br><br>Admet `count`.| |selectDashboards|query|Retorna una propietat [taulers](/manual/api/reference/templatedashboard/object).<br><br>Admet `count`.| |selectTags|query|Retorna una propietat [etiquetes](/manual/api/reference/host/object#host_tag) amb totes les etiquetes d'equip.| |selectInheritedTags|query|Retorna una propietat [inheritedTags](/manual/api/reference/host/object#host_tag) amb les etiquetes que es troben a tots els models vinculats a l'equip.| |selectTriggers|query|Retorna una propietat [triggers](/manual/api/reference/trigger/object) amb triggers de l'equip.<br><br>Admet `count`.| |selectValueMaps|query|Retorna una propietat [valuemaps](/manual/api/reference/valuemap/object) amb mapes de valors de l'equip.| |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>Permet filtrar per propietats de la interfície.| |limitSelects|integer|Limita el nombre de registres retornats per subconsultes.<br><br>S'aplica a les subconsultes següents:<br>`selectParentTemplates` - els resultats s'ordenaran per `host`;< br>`selectInterfaces`;< 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`.| |search|object|Retorna resultats que coincideixen amb la cerca genèrica donada.<br><br>Accepta una matriu on les claus són noms de propietat i els valors són cadenes per cercar. Si no es donen opcions addicionals, es farà una cerca `LIKE "%...%"`.<br><br>Us permet cercar per propietats de la interfície. Només funciona amb camps de text.| |searchInventory|object|Retorna només els equips les dades d'inventari dels quals coincideixen amb la cerca genèrica donada.<br><br>Aquest paràmetre es veu afectat pels mateixos paràmetres addicionals que "cerca".| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Valors possibles: `hostid`, `host`, `name`, `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|^| |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| |--|--|------| |groupids|string/array|Return only maintenances that are assigned to the given host groups.| |hostids|string/array|Return only maintenances that are assigned to the given hosts.| |maintenanceids|string/array|Return only maintenances with the given IDs.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups assigned to the maintenance.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts assigned to the maintenance.| |selectTags|query|Return a [tags](/manual/api/reference/maintenance/object#problem_tag) property with problem tags of the maintenance.| |selectTimeperiods|query|Return a [timeperiods](/manual/api/reference/maintenance/object#time_period) property with time periods of the maintenance.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `maintenanceid`, `name` and `maintenance_type`.| |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àmetre definint la sortida esperada.  El mètode admet els següents paràmetres.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupids|string/array|Retorna només els manteniments assignats als grups d'equips donats.| |hostids|string/array|Retorna només els manteniments assignats als equips donats.| |maintenanceids|string/array|Retorna només manteniments amb els identificadors donats.| |selectGroups|query|Retorna una propietat [grups](/manual/api/reference/hostgroup/object) que conté els grups d'equips assignats al manteniment.| |selectHosts|query|Retorna una propietat [equips](/manual/api/reference/host/object) que conté els equips assignats per al manteniment.| |selectTags|query|Retorna una propietat [etiquetes](/manual/api/reference/maintenance/object#problem_tag) que conté les etiquetes del problema de manteniment.| |selectTimeperiods|query|Retorna una propietat [timeperiods](/manual/api/reference/maintenance/object#time_period) que conté els períodes de manteniment.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `userid` i `alias`.| |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| |--|--|------| |groupids|string/array|Return only scripts that can be run on the given host groups.| |hostids|string/array|Return only scripts that can be run on the given hosts.| |scriptids|string/array|Return only scripts with the given IDs.| |usrgrpids|string/array|Return only scripts that can be run by users in the given user groups.| |selectGroups|query|Return a [groups](/manual/api/reference/hostgroup/object) property with host groups that the script can be run on.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with hosts that the script can be run on.| |selectActions|query|Return a [actions](/manual/api/reference/action/object) property with actions that the script is associated with.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `scriptid` and `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ó| |--|--|------| |groupids|string/array|Retorna només scripts que es poden executar als grups d'equips donats.| |hostids|string/array|Retorna només scripts que es poden executar als equips donats.| |scriptids|string/array|Retorna només scripts amb els ID donats.| |usrgrpids|string/array|Retorna només scripts que poden ésser executats pels usuaris dels grups d'usuaris determinats.| |selectGroups|query|Retorna una propietat [grups](/manual/api/reference/hostgroup/object) amb els grups d'equips on es pot executar l'script.| |selectHosts|query|Retorna una propietat [equips](/manual/api/reference/host/object) amb els equips en què es pot executar l'script.| |selectActions|query|Retorna una propietat [accions](/manual/api/reference/action/object) amb les accions a les quals està associat l'script.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `scriptid` 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| |--|--|------| |groupids|string/array|Return only web scenarios that belong to the given host groups.| |hostids|string/array|Return only web scenarios that belong to the given hosts.| |httptestids|string/array|Return only web scenarios with the given IDs.| |inherited|boolean|If set to `true` return only web scenarios inherited from a template.| |monitored|boolean|If set to `true` return only enabled web scenarios that belong to monitored hosts.| |templated|boolean|If set to `true` return only web scenarios that belong to templates.| |templateids|string/array|Return only web scenarios that belong to the given templates.| |expandName|flag|Expand macros in the name of the web scenario.| |expandStepName|flag|Expand macros in the names of scenario steps.| |evaltype|integer|Rules for tag searching.<br><br>Possible values:<br>0 - (default) And/Or;<br>2 - Or.| |tags|array of objects|Return only web scenarios 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 web scenarios.<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.| |selectHosts|query|Return the hosts that the web scenario belongs to as an array in the [hosts](/manual/api/reference/host/object) property.| |selectSteps|query|Return web scenario steps in the [steps](/manual/api/reference/httptest/object#scenario_step) property.<br><br>Supports `count`.| |selectTags|query|Return the web scenario tags in [tags](/manual/api/reference/httptest/object#web_scenario_tag) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `httptestid` and `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ó| |--|--|------| |groupids|string/array|Retorna només escenaris web que pertanyen als grups d'equips donats.| |hostids|string/array|Retorna només escenaris web que pertanyen als equips donats.| |httptestids|string/array|Retorna només escenaris web amb identificadors donats.| |inherited|boolean|Si es defineix com a `true`, només retorna escenaris web heretats d'una plantilla.| |monitored|boolean|Si s'estableix en `true`, només retorna els escenaris web activats que pertanyen als equips monitorats.| |templed|boolean|Si s'estableix en `true`, només retorna escenaris web pertanyents a plantilles.| |templateids|string/array|Retorna només escenaris web que pertanyen a les plantilles donades.| |expandName|flag|Amplia les macros al nom de l'escenari web.| |expandStepName|flag|Amplia les macros als noms de les passes dels escenaris.| |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 escenaris web amb les 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>", " operador": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els escenaris web.<br><br>Possibles tipus d'operadors:<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.| |selectHosts|query|Retorna els equips als quals pertany l'escenari web com a matriu a la propietat [equips](/manual/api/reference/host/object).| |selectSteps|query|Retorna les passes de l'escenari web a la propietat [passes](/manual/api/reference/httptest/object#scenario_step).<br><br>Admet `count`.| |selectTags|query|Retorna etiquetes d'escenari web a la propietat [etiquetes](/manual/api/reference/httptest/object#web_scenario_tag).| |sortfield|string/array|Ordena el resultat per propietats donades.<br><br>Els valors possibles són: `httptestid` 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| |--|--|------| |ha\_nodeids|string/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 array, where the keys are property names, and the values are either a single value or an array of values to match against.<br><br>Allows filtering by the node properties: `name`, `address`, `status`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `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|string/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 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>Permet filtrar per propietats del node: `name`, `address`, `status`.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `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 - numeric unsigned;<br>4 - text.<br><br>Default: 3.| |hostids|string/array|Return only history from the given hosts.| |itemids|string/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 are: `itemid` and `clock`.| |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|Descripció| |--|--|------| |history|integer|Els tipus d'objectes de l'històric a retornar.<br><br>Valors possibles:<br>0 - flotant numèric;<br>1 - caràcter;<br>2 - registre;<br> 3 - numèric sense signe;<br>4 - text.<br><br>Per defecte: 3.| |hostids|string/array|Retorna només l'històric dels equips donats.| |itemids|string/array|Retorna només l'històric dels elements donats.| |time\_from|timestamp|Retorna només els valors rebuts després o a l'hora especificada.| |time\_till|timestamp|Retorna només els valors rebuts abans o a l'hora especificada.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `itemid` i `clock`.| |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|^| |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|string/array|Return only host interfaces used by the given hosts.| |interfaceids|string/array|Return only host interfaces with the given IDs.| |itemids|string/array|Return only host interfaces used by the given items.| |triggerids|string/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 are: `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|string/array|Retorna només les interfícies d'equip emprades pels equips donats.| |interfaceids|string/array|Retorna només les interfícies d'equip amb els identificadors donats.| |itemids|string/array|Retorna només les interfícies d'equip emprades pels elements donats.| |triggerids|string/array|Retorna només les interfícies d'equip emprades pels triggers donats.| |selectItems|query|Retorna una propietat [elements](/manual/api/reference/host/object) que conté els elements que empren la interfície.<br><br>Admet `count`.| |selectHosts|query|Retorna una propietat [equips](/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|string/array|Return only host prototypes with the given IDs.| |discoveryids|string/array|Return only host prototype 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 are: `hostid`, `host`, `name` and `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|string/array|Retorna només els prototips d'equips amb els identificadors donats.| |discoveryids|string/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 [regla de descoberta](/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 [interfícies](/manual/api/reference/hostprototype/object#custom_interface) que conté les interfícies personalitzades del prototip d'equips.| |selectGroupLinks|query|Retorna una propietat [enllaços de grups](/manual/api/reference/hostprototype/object#group_link) que conté els enllaços de grup del prototip d'equips.| |selectGroupPrototypes|query|Retorna una propietat [protipus de grups](/manual/api/reference/hostprototype/object#group_prototype) que conté els prototips de grup del prototip d'equips.| |selectMacros|query|Retorna una propietat [macro](/manual/api/reference/usermacro/object) que conté les macros del prototip d'equips.| |selectParentHost|query|Retorna una propietat [equip pare](/manual/api/reference/host/object) que conté l'equip al qual pertany el prototip d'equips.| |selectTags|query|Retorna una propietat [etiquetes](/manual/api/reference/hostprototype/object#host_prototype_tag) que conté les etiquetes del prototip d'equips.| |selectTemplates|query|Retorna una propietat [plantilles](/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|string/array|Return only icon maps with the given IDs.| |sysmapids|string/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 are: `iconmapid` and `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|string/array|Torna només els mapes d'icones amb els identificadors donats.| |sysmapids|string/array|Torna només els mapes d'icones emprats als mapes donats.| |selectMappings|query|Torna una propietat [mappings](/manual/api/reference/iconmap/object#icon_mapping) amb els mapes d'icones emprats.| |sortfield|string/array|Ordena el resultat segons les propietats de les dades.<br><br>Els valors admesos són: `iconmapid` 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|string/array|Return only images with the given IDs.| |sysmapids|string/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 are: `imageid` and `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|string/array|Retorna només imatges amb els identificadors donats.| |sysmapids|string/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|string/array|Return only items with the given IDs.| |groupids|string/array|Return only items that belong to the hosts from the given groups.| |templateids|string/array|Return only items that belong to the given templates.| |hostids|string/array|Return only items that belong to the given hosts.| |proxyids|string/array|Return only items that are monitored by the given proxies.| |interfaceids|string/array|Return only items that use the given host interfaces.| |graphids|string/array|Return only items that are used in the given graphs.| |triggerids|string/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 of objects|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>`ts_delete` - `(timestamp)` time when an item that is no longer discovered will be deleted.| |selectPreprocessing|query|Return a [preprocessing](/manual/api/reference/item/object#item_preprocessing) property with item preprocessing options.<br><br>It has the following properties:<br>`type` - `(string)` The preprocessing option type:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check for not supported value;<br>27 - XML to JSON.<br><br>`params` - `(string)` Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n)character.<br>`error_handler` - `(string)` Action type used in case of preprocessing step failure:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.<br><br>`error_handler_params` - `(string)` Error handler parameters.| |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 array, 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 additional filters:<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 are: `itemid`, `name`, `key_`, `delay`, `history`, `trends`, `type` and `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|string/array|Retorna només els elements amb els identificadors donats.| |groupids|string/array|Retorna només els elements que pertanyen als equips dels grups donats.| |templateids|string/array|Retorna només els elements que pertanyen a les plantilles donades.| |hostids|string/array|Retorna només els elements que pertanyen als equips donats.| |proxyids|string/array|Retorna només els elements monitorats pels proxys donats.| |interfaceids|string/array|Retorna només elements que empren les interfícies d'equip donades.| |graphids|string/array|Retorna només els elements emprats en els gràfics donats.| |triggerids|string/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.| |template|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 [equips](/manual/api/reference/host/object) que conté una matriu d'equips a què pertany l'element.| |selectInterfaces|query|Retorna una propietat [interfícies](/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 [gràfics](/manual/api/reference/graph/object) que conté els gràfics que empra l'element.<br><br>Admet `count`.| |selectDiscoveryRule|query|Retorna una propietat [regla de descoberta](/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` - `(cadena)` Identificador de descoberta de l'element;<br>`itemid ` - `(cadena)` Identificació de l'element descobert ;<br>`parent_itemid` - `(cadena)` 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>`ts_delete` - `(timestamp)` quan s'esborrarà un element que ja no es descobreix.| |selectPreprocessing|query|Retorna una propietat [preprocessament](/manual/api/reference/item/object#item_preprocessing) que conté opcions de preprocessament d'elements.<br><br>Té les propietats següents:<br>`type ` - ` (cadena)` Tipus d'opcions de preprocessament:<br>1 - Multiplicador personalitzat;<br>2 - Eliminació d'espais en blanc al final;<br>3 - Eliminació d'espais en blanc al final;<br>4 - Eliminació dels espais inicials i finals;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br> 9 - Canvi únic;<br>10 - Canvi per segon;<br >11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular ;<br>15 - No coincideix amb l'expressió regular ;<br>16 - Troba l'error en JSON ;<br>17 - Trobar l'error en XML ;<br>18 - Trobar l'error amb una expressió regular;<br>19 - Suprimir sense modificacions;<br> 20 - Suprimeix sense modificacions amb batec;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometeu a JSON;<br>24 - CSV a JSON; <br>25 - Substituïu ;<br>26 - Comproveu si hi ha valors no compatibles ​​;<br>27 - XML ​​​​a JSON.<br><br>`params` - `(string)` Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats per un caràcter LF (\\n).<br>`error_handler` - `(cadena)` Tipus d'acció que s'empra en l'error del pas de preprocessament:<br>0 - El servidor Zabbix defineix el missatge d'error; <br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat. <br><br>`error_handler_params` - `(cadena)` Paràmetres del gestor d'errors.| |selectTags|query|Retorna etiquetes d'element a la propietat [etiquetes](/manual/api/reference/item/object#Item_tag).| |selectValueMap|query|Retorna una propietat [mapa de valors](/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 `nom`;< br>`selectTriggers`: resultats s'ordenarà per `descripció`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `itemid`, `name`, `key_`, `delay`, `history`, `trends` , `tipus` i `estat`.| |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|string/array|Return only LLD rules with the given IDs.| |groupids|string/array|Return only LLD rules that belong to the hosts from the given groups.| |hostids|string/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|string/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|string/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 array, 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 additional filters:<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:<br>`selectItems`;<br>`selectGraphs`;<br>`selectTriggers`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `itemid`, `name`, `key_`, `delay`, `type` and `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|string/array|Retorna només les regles amb els ID donats.| |groupids|string/array|Retorna només les regles que pertanyen als grups d'equips donats.| |hostids|string/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|string/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|string/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|objecte|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>`selectItems`;<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|string/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|string/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|string/array|Return only users that use the given media.| |mediatypeids|string/array|Return only users that use the given media types.| |userids|string/array|Return only users with the given IDs.| |usrgrpids|string/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 are: `userid` and `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|string/array|Retorna només els usuaris que són emprant el suport donat.| |mediatypeids|string/array|Retorna només els usuaris que empren els tipus de suport donats.| |userids|string/array|Retorna només els usuaris amb els identificadors donats.| |usrgrpids|string/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` - *(enteger)* 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|string/array|Return only media types with the given IDs.| |mediaids|string/array|Return only media types used by the given media.| |userids|string/array|Return only media types used by the given users.| |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 are: `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|string/array|Retorna només els tipus de suport amb els identificadors donats.| |mediaids|string/array|Retorna només els tipus de suport emprats pel suport donat.| |userids|string/array|Retorna només els tipus de suport emprats pels usuaris donats.| |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 [usuaris](//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| |--|--|------| |proxyids|string/array|Return only proxies with the given IDs.| |selectHosts|query|Return a [hosts](/manual/api/reference/host/object) property with the hosts monitored by the proxy.| |selectInterface|query|Return an [interface](/manual/api/reference/proxy/object#proxy_interface) property with the proxy interface used by a passive proxy.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `hostid`, `host` and `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ó| |--|--|------| |proxyids|string/array|Retorna només proxys amb els identificadors donats.| |selectHosts|query|Retorna una propietat [equips](/manual/api/reference/host/object) amb els equips monitorats pel proxy.| |selectInterface|query|Retorna una propietat [interfície](/manual/api/reference/proxy/object#proxy_interface) amb la interfície proxy emprada per un proxy passiu.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Els valors possibles són: `hostid`, `host` 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| |--|--|------| |regexpids|string/array|Return only regular expressions with the given IDs.| |selectExpressions|query|Return a [expressions](/manual/api/reference/regexp/object#expressions) property.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `regexpid` and `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 esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |regexpids|string/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>Els valors possibles són: `regexpid` 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| |--|--|------| |reportids|string/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 are: `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  `(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ó| |--|--|------| |reportids|string/array|Retorna només els informes programats amb els ID d'informes especificats.| |expired|boolean|Si s'estableix a `true`, només es retornen els informes programats caducats; si és `false` - només els informes programats actius.| |selectUsers|query|Retorna una propietat [usuaris](/manual/api/reference/user/object) a la qual és configurat per enviar l'informe.| |selectUserGroups|query|Retorna una propietat [usuari\_grups](/manual/api/reference/user/object) a la qual és configurat per enviar l'informe.| |sortfield|string/array|Ordena el resultat per 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 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| |--|--|------| |roleids|string/array|Return only roles with the given IDs.| |selectRules|query|Return role rules in the [rules](/manual/api/reference/role/object#role_rules) property.| |selectUsers|query|Select [users](/manual/api/reference/user/object) this role is assigned to.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values are: `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|string/array|Retorna només els rols amb els ID donats.| |selectRules|query|Retorna les regles de rol a la propietat [regles](/manual/api/reference/role/object#role_rules).| |selectUsers|query|Retorna els [usuaris](/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                                                                                                                                                               | |-------------------------|-----------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | slaids                  | string/array                                        | Return only SLAs with the given IDs.                                                                                                                                      | | serviceids              | string/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 are: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status` and `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  `(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ó| |-----------|-------------------------------------- -----------------|---------------------------------- ----------------------------------- --------------- ----------------------------------- --------------- ---------------------------------------| | slaids | string/array | Retorneu només els SLA amb els identificadors proporcionats.| | serviceids | string/array | Retorneu només els SLA corresponents als 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 exclosos del SLA.<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 segons les propietats donades.<br><br>Els valors possibles són: `slaid`, `name`, `period`, `slo`, `effective_date`, `timezone`, `status` i ` descripció'.| |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-parameters-of-the-get-method).| |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| |--|--|------| |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|string/array|Return only user groups that contain the given users.| |usrgrpids|string/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.<br><br>It has the following properties:<br>`groupid` - (string) ID of the host group;<br>`tag` - (string) tag name;<br>`value` - (string) tag value.| |selectUsers|query|Return the users from the user group in the [users](/manual/api/reference/user/object#user) property.| |selectRights|query|Return user group rights in the [rights](/manual/api/reference/usergroup/object#permission) property.<br><br>It has the following properties:<br>`permission` - (integer) access level to the host group;<br>`id` - (string) ID of the host group.<br><br>Refer to the [user group page](object#permission) for a list of access levels to host 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 are: `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|^|
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ó| |--|--|------| |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|string/array|Retorna només els grups d'usuaris que contenen els usuaris especificats.| |usrgrpids|string/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).<br><br>Té les propietats següents:<br>`groupid ` - (cadena ) ID del grup d'equips;<br>`etiqueta` - nom de l'etiqueta (cadena);<br>`valor` - valor de l'etiqueta (cadena).| |selectUsers|query|Retorna els usuaris del grup d'usuaris a la propietat [usuaris](/manual/api/reference/user/object#user).| |selectRights|query|Retorna els permisos del grup d'usuaris a la propietat [permisos](/manual/api/reference/usergroup/object#permission).<br><br>Té les propietats següents:<br>' permís ` - (enter) nivell d'accés del grup d'equips;<br>`id` - (cadena) ID del grup d'equips.<br><br>Consulteu [pàgina del grup d'usuaris](objecte#permissió) per obtindre una llista dels nivells d'accés del grup d'equips.| |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|^|

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|string/array|Returns only maps with the given IDs.| |userids|string/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 are: `name`, `width` and `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|string/array|Retorna només mapes amb els identificadors donats.| |userids|string/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: `nom`, `amplada` i `alçada`.| |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|string/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|string/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|string/array|Return only templates with the given template IDs.| |groupids|string/array|Return only templates that belong to the given host groups.| |parentTemplateids|string/array|Return only templates that are parent to the given templates.| |hostids|string/array|Return only templates that are linked to the given hosts/templates.| |graphids|string/array|Return only templates that contain the given graphs.| |itemids|string/array|Return only templates that contain the given items.| |triggerids|string/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.| |selectGroups|query|Return the host groups that the template belongs to in the [groups](/manual/api/reference/hostgroup/object) property.| |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`.| |selectTemplates|query|Return templates to which the template is a child, in the [`templates`](/manual/api/reference/template/object) property.<br><br>Supports `count`.| |selectParentTemplates|query|Return templates to which the template is a parent, 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 are: `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ó| |--|--|------| |templateids|string/array|Retorna només plantilles amb els ID de plantilla donats.| |groupids|string/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|string/array|Retorna només patrons relacionats amb els hosts/patrons donats.| |graphids|string/array|Retorna només els models que contenen els gràfics donats.| |itemids|string/array|Retorna només els models que contenen els elements donats.| |triggerids|string/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.| |selectGroups|query|Retorna els grups d'equips als quals pertany la plantilla a la propietat [grups](/manual/api/reference/hostgroup/object).| |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`.| |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|^|

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|string/array|Return only tokens with the given IDs.| |userids|string/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 are: `tokenid`, `name`, `lastaccess`, `status`, `expires_at` and `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|string/array|Retorna només tokens amb els ID donats.| |userids|string/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).| |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| |--|--|------| |triggerids|string/array|Return only triggers with the given IDs.| |groupids|string/array|Return only triggers that belong to hosts from the given host groups.| |templateids|string/array|Return only triggers that belong to the given templates.| |hostids|string/array|Return only triggers that belong to the given hosts.| |itemids|string/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 from the host 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 of objects|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.| |selectGroups|query|Return the host groups that the trigger belongs to in the [groups](/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` - *(string)* ID of the function;<br>`itemid` - *(string)* 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.| |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.| |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` - `(string)` ID of the trigger prototype from which the trigger has been created.| |filter|object|Return only those results that exactly match the given filter.<br><br>Accepts an array, 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 additional filters:<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 are: `triggerid`, `description`, `status`, `priority`, `lastchange` and `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|^|
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|string/array|Retorna només triggers amb els identificadors donats.| |groupids|string/array|Retorna només triggers que pertanyen als equips dels grups d'equips donats.| |templateids|string/array|Retorna només triggers que pertanyen a les plantilles donades.| |hostids|string/array|Retorna només triggers que pertanyen als equips donats.| |itemids|string/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.| |selectGroups|query|Retorna els grups d'equips als quals pertany el trigger a la propietat [grups](/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` - *(string)* ID de la funció;<br>`itemid` - *(string)* ID de l'element emprat a la funció;<br>`function` - *(string)* nom de la funció; <br>` paràmetre` - *(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).| |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|^| |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| |--|--|------| |valuemapids|string/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 are: `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	### Parpametres  `(object)` Parametres definint la sortida esperada.  Aquest mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |valuemapids|string/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 [mapatges](/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 desired output.  The method supports the following parameters.  | Parameter              | [Type](/manual/api/reference_commentary#data_types) |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | |------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | serviceids             | string/array                                        | Return only services with the given IDs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | | parentids              | string/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               | string/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                 | string/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` - *(string)* 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 are: `serviceid`, `name`, `status`, `sortorder` and `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  `(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)| | |------------------------|-----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | serviceids | string/array | Retorna només els serveis amb els identificadors proporcionats. | | parentids | string/array | Retorna només els serveis relacionats amb els serveis dels pares donats. | | deep\_parentids | flag | Retornar tots els serveis directes i indirectes als fills. S'empra amb `parentids`. | | childids | string/array | Retorna només els serveis relacionats amb els serveis per a fills donats. | | evaltype | integer | Regles de cerca d'etiquetes.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.| | tags | object/array of objects | Retorna només els serveis amb etiquetes especificades. 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 serveis.<br><br>Possibles valors d'operador:<br>0 - *(per defecte)* Conté;<br >1 - És igual;<br>2 - No conté;<br>3 - No ho ésés igual;<br>4 - Existeix;<br>5 - No existeix.| | problem\_tags | object/array of objects | Retorna només els serveis amb etiquetes de problema 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 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 | Retorna només els serveis sense una etiqueta de problema. | | assassinat | string/array | Retorna  només els serveis relacionats amb els SLA específics. | | selectChildren | query | Retorna una propietat `children` amb serveis per a fills.<br><br>Admet `count`. | | selectParents | query | Retorna una propietat `parents` amb serveis pare.<br><br>Admet `count`. | | selectTags | query | Retorna una propietat [etiquetes](/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)* ID de l'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 | object/array of objects | Retorna una propietat `status_timeline` que conté canvis d'estat del servei per a períodes de temps determinats.<br><br>Format `[{"period_from": "<period_from>", "period_to": "<period_to>"}, ...] ` - on `period_from` és una data d'inici (inclosa; marca de temps sencera) i `period_to` és una data de finalització (exclusiva; marca de temps sencera) per al període d'interès.<br><br>Retorna una matriu d'entrades que contenen un `start_value` i una matriu [alarmes](/manual/api/reference/service/object#service-alarm) per als canvis d'estat en períodes de temps especificats. |   |||| |------------------------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | sortfield | string/array | Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `serviceid`, `name`, `status`, `sortorder` i `created_at`.| |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|^|

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 to be copied.| |hostids|array|IDs of the hosts 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 que s'han de copiar.| |hostids|array|IDs dels equips 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**<br>(required)|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.| |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**<br>(required)|object|Objects to be exported.<br><br>The `options` object has the following parameters:<br>`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>`templates` - `(array)` IDs of templates to export.<br>|
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**<br>(obligatori)|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.| |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**<br>(obligatori)|objecte|Objectes a exportar.<br><br>L'objecte `options` té els paràmetres següents:<br>`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>`templates` - `(array)` IDs de les plantilles a exportar.<br>|

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

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|