en-us	### Parameters  `(object/array)` Parameters containing the IDs of the events and update operations that should be performed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventids|string/object|IDs of the events to acknowledge.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |action|integer|Event update action(s).<br>This is a bitmask field, any combination of possible bitmap values is acceptable.<br><br>Possible bitmap values:<br>1 - close problem;<br>2 - acknowledge event;<br>4 - add message;<br>8 - change severity;<br>16 - unacknowledge event;<br>32 - suppress event;<br>64 - unsuppress event;<br>128 - change event rank to cause;<br>256 - change event rank to symptom.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |cause_eventid|string|Cause event ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `action` contains the "change event rank to symptom" bit| |message|string|Text of the message.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `action` contains the "add message" bit| |severity|integer|New severity for events.<br><br>Possible values:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `action` contains the "change severity" bit| |suppress_until|integer|Unix timestamp until which event must be suppressed.<br><br>If set to "0", the suppression will be indefinite.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `action` contains the "suppress event" bit|
ca	### Paramètres  `(object/array)` Paràmetres que contenen identificadors d'esdeveniments i operacions d'actualització a realitzar.  |Paràmetre|Tipus|Descripció| |----------|----|-----------| |eventids|string/object|ID dels esdeveniments a reconèixer.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |action|integer|Accions d'actualització d'esdeveniments. Aquest camp és una màscara de bits, qualsevol combinació de valors és acceptable.<br><br>Valors possibles:<br>1 - tanqueu el problema;<br>2 - reconeixeu l'esdeveniment;<br>4 - afegiu un missatge ;<br>8 - canviar la gravetat;<br>16 - no reconèixer l'esdeveniment.<br>32 - esborrar esdeveniment;<br>64 - recuperar esdeveniment esborrat;<br>128 - canviar la classificació d'esdeveniment a causa;<br>256 - canviar la classificació de l'esdeveniment a símptoma.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |vcause_eventid|string|ID de l'esdeveniment causa.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `action`conté el bit "canviar la categoria de l'element a símptoma"| |message|string|Text del missatge.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `action`conté el bit "afegir missatge"| |severity|integer|Gravetat de l'esdeveniment nou.<br>**Obligatori**, si l'acció conté 'canviar la gravetat'.<br><br>Valors possibles:<br>0 - sense classificar;<br> 1 - informació;< br>2 - avís;<br>3 - mitjà;<br>4 - alt;<br>5 - desastre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `action`conté el bit "canviar gravetat"| |supress_until|integer|La marca de temps d'Unix fins quan l'esdeveniment s'ha d'esborrar.<br><br>Si s'estableix a "0", l'esborrar serà indefinit.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `action`conté el bit "esborrar esdeveniment"|

en-us	### Parameters  `(object/array)` Proxies to create.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to be created for the passive proxy.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `status` of [Proxy object](object#proxy) is set to "passive proxy"|
ca	### Paràmetres  `(object/array)` Proxys a crear.  A més de les [propietats proxy estàndard] (object#proxy), el mètode accepta els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hosts|array|[Equips](/manual/api/reference/host/object) per ésser monitorats pel proxy. Si un equip ja és monitorat per un proxy diferent, es reassignarà al proxy actual.<br><br>Els equips han de tindre la propietat `hostid` establerta.| |interface|object|[Interfície](/manual/api/reference/hostinterface/object) equip per crear per al proxy passiu.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `status` de l'[objecte proxy](object#proxy) és "obligatori per proxys passius"|

en-us	### Parameters  `(object/array)` Proxy properties to be updated.  The `proxyid` property must be defined for each proxy, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard proxy properties](object#proxy), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|array|[Hosts](/manual/api/reference/host/object) to be monitored by the proxy. If a host is already monitored by a different proxy, it will be reassigned to the current proxy.<br><br>The hosts must have the `hostid` property defined.| |interface|object|Host [interface](/manual/api/reference/hostinterface/object) to replace the existing interface for the passive proxy.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if `status` of [Proxy object](object#proxy) is set to "passive proxy"|
ca	### Paràmetres  `(object/array)` Propietats del proxy per actualitzar.  La propietat `proxyid` s'ha d'establir per a cada proxy, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats proxy estàndard](objecte#proxy), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hosts|array|[Equips](/manual/api/reference/host/object) per ésser monitorats pel proxy. Si un equip ja és monitorat per un proxy diferent, es reassignarà al proxy actual.<br><br>Els equips han de tindre la propietat `hostid` establerta.| |interface|object|[Interfície de l'equip](/manual/api/reference/hostinterface/object) substituint la interfície existent per al proxy passiu.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `status` de l'[objecte Proxy](object#proxy) s'estableix a "proxy passiu".|

en-us	### Parameters  `(object/array)` Regular expression properties to be updated.  The `regexpid` property must be defined for each object, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard properties](object#expressions), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |expressions|array|[Expressions](/manual/api/reference/regexp/object#expressions) options.|
ca	### Paràmetres  `(object/array)` Propietats d'expressió regular per actualitzar.  La propietat `regexpid` s'ha d'establir per a cada objecte, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, les altres romandran sense canvis.  A més de les [propietats estàndard](object#expressions_object), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |expressions|array|Opcions d'[expressions](/manual/api/reference/regexp/object#expressions_object).|

en-us	### Parameters  `(object/array)` Regular expressions to create.  Additionally to the [standard properties](object), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |expressions|array|[Expressions](/manual/api/reference/regexp/object#expressions) options.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object/array)` Expressions regulars per crear.  A més de les [propietats estàndard](object), el mètode admete els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |expressions|array|Opcions d'[expressions](/manual/api/reference/regexp/object#expressions_object).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object/array)` Role properties to be updated.  The `roleid` property must be defined for each role, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard role properties](object#role) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rules|array|Access [rules](object#role_rules) to replace the current access rules assigned to the role.|
ca	### Paràmetres  `(object/array)` Propietats del rol per actualitzar.  La propietat `roleid` s'ha d'establir per a cada rol, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats de rol estàndard](object#role), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |rules|array|[Regles](object#role_rules) d'accés anul·lant les regles d'accés actuals assignades al rol.|

en-us	### Parameters  `(object/array)` Roles to create.  Additionally to the [standard role properties](object#role), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |rules|array|Role [rules](object#role_rules) to be created for the role.|
ca	### Paràmetres  `(object/array)` Rols a crear.  A més de les [propietats de rol estàndard](object#role), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |rules|array|[Regles](objecte#role_rules) del rol que cal crear per al rol.|

en-us	### Parameters  `(object/array)` Scheduled report properties to be updated.  The `reportid` property must be defined for each scheduled report, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard scheduled report properties](object#report) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |users|object/array|[Users](object#users) to replace the current users assigned to the scheduled report.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `user_groups` is not set| |user\_groups|object/array|[User groups](object#user_groups) to replace the current user groups assigned to the scheduled report.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `users` is not set|
ca	### Paràmetres  `(object/array)` Propietats de l'informe programat per actualitzar.  La propietat `reportid` s'ha d'establir per a cada informe programat, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, les altres romandran sense canvis.  A més de les [propietats d'informe programat estàndard](object#report), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |users|object/array of objects|[Usuaris](object#users) substituint els usuaris actuals assignats a l'informe programat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `user_groups` no s'ha establert| |user\_groups|object/array of objects|[Grups d'usuaris](object#user_groups) substituint els grups d'usuaris actuals assignats a l'informe programat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `users` no s'ha establert|

en-us	### Parameters  `(object/array)` Scheduled reports to create.  Additionally to the [standard scheduled report properties](object#report), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |users|object/array|[Users](object#users) to send the report to.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `user_groups` is not set| |user\_groups|object/array|[User groups](object#user_groups) to send the report to.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `users` is not set|
ca	### Paràmetres  `(object/array)` Informes programats per crear.  A més de les [propietats d'informe programat estàndard] (object#report), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |users|object/array of objects|[Usuaris](objecte#usuaris) als qui enviar l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si no s'ha establert `user_groups`| |user\_groups|object/array of objects|[Grups d'usuaris](objecte#grups_usuaris) als qui enviar l'informe.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si no s'ha establert `users`|

en-us	### Parameters  `(object/array)` [Script properties](object#script) to be updated.  The `scriptid` property must be defined for each script, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged. An exception is `type` property change from 5 (Webhook) to other: the `parameters` property will be cleaned.
ca	### Paràmetres  `(object/array)` [Propietats de l'script](object#script) per actualitzar.  La propietat `scriptid` s'ha d'establir per a cada script, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis. Una excepció és canviar la propietat `type` de 5 (Webhook) a una altra: la propietat `parameters` es netejarà.

en-us	### Parameters  `(object/array)` Scripts to create.  The method accepts scripts with the [standard script properties](/manual/api/reference/script/object#script).
ca	### Paràmetres  `(object/array)` Scripts a crear.  el mètode admet scripts amb les [propietats d'script standard](/manual/api/reference/script/object#script).

en-us	### Parameters  `(object/array)` service properties to be updated.  The `serviceid` property must be defined for each service, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)| Description| |--|--|------| |children|array|Child services to replace the current service children.<br><br>The children must have the `serviceid` property defined.| |parents|array|Parent services to replace the current service parents.<br><br>The parents must have the `serviceid` property defined.| |tags|array|Service [tags](/manual/api/reference/service/object#service_tag) to replace the current service tags.| |problem\_tags|array|[Problem tags](/manual/api/reference/service/object#problem_tag) to replace the current problem tags.| |status\_rules|array|[Status rules](/manual/api/reference/service/object#status_rule) to replace the current status rules.|
ca	### Paràmetres  Les propietats del servei `(objecte/matriu)` s'han d'actualitzar.  La propietat `serviceid` s'ha de definir per a cada servei, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats del servei estàndard](objecte#servei), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)| Descripció| |--|--|------| |children|array|Serveis secundaris per substituir els fills del servei actuals.<br><br>Els fills han de tindre la propietat `serviceid` definida.| |parents|array|Serveis pare per substituir els pares del servei actuals.<br><br>Els pares han de tindre definida la propietat `serviceid`.| |tags|matriu|Servei [etiquetes](/manual/api/reference/service/object#service_tag) per substituir les etiquetes de servei actuals.| |problem\_tags|array|[Problem tags](/manual/api/reference/service/object#problem_tag) per substituir les etiquetes de problema actuals.| |status\_rules|array|[Regles d'estat](/manual/api/reference/service/object#status_rule) per substituir les regles d'estat actuals.|

en-us	### Parameters  `(object/array)` services to create.  Additionally to the [standard service properties](object#service), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |children|array|Child services to be linked to the service.<br><br>The children must have the `serviceid` property defined.| |parents|array|Parent services to be linked to the service.<br><br>The parents must have the `serviceid` property defined.| |tags|array|Service [tags](/manual/api/reference/service/object#service_tag) to be created for the service.| |problem\_tags|array|[Problem tags](/manual/api/reference/service/object#problem_tag) to be created for the service.| |status\_rules|array|[Status rules](/manual/api/reference/service/object#status_rule) to be created for the service.|
ca	### Paràmetres  Serveis `(objecte/matriu)` per crear.  A més de les [propietats del servei estàndard](objecte#servei), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |children|array|Els serveis secundaris s'han d'enllaçar al servei.<br><br>Els fills han de tenir la propietat `serviceid` definida.| |parents|array|Els serveis parentals s'han d'enllaçar al servei.<br><br>Els pares han de tenir definida la propietat `serviceid`.| |tags|matriu|Servei [etiquetes](/manual/api/reference/service/object#service_tag) que cal crear per al servei.| |problem\_tags|array|[Problem tags](/manual/api/reference/service/object#problem_tag) que s'ha de crear per al servei.| |status\_rules|array|[Regles d'estat](/manual/api/reference/service/object#status_rule) que s'ha de crear per al servei.|

en-us	### Parameters  `(object/array)` SLA objects to create.  Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |service_tags|array|[SLA service tags](/manual/api/reference/sla/object#sla-service-tag) to be created for the SLA.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |schedule|array|[SLA schedule](/manual/api/reference/sla/object#sla-schedule) to be created for the SLA.<br>Specifying an empty parameter will be interpreted as a 24x7 schedule.<br>Default: 24x7 schedule.| |excluded_downtimes|array|[SLA excluded downtimes](/manual/api/reference/sla/object#sla-excluded-downtime) to be created for the SLA.|
ca	### Paràmetres  `(object/array)` Objectes SLA per crear.  A més de les [propietats SLA estàndard](objecte#sla), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |service_tags|array|[Etiquetes de servei SLA](/manual/api/reference/sla/object#sla-service-tag) que s'ha de crear per a l'SLA.<br><br>[Comportament del paràmetre](/manual/api /reference_commentary#parameter-behavior):<br>- *obligatori*| |schedule|array|[programació SLA](/manual/api/reference/sla/object#sla-schedule) que s'ha de crear per a l'SLA.<br>Especificar un paràmetre buit s'interpretarà com una planificació 24x7.<br> Per defecte: programació 24x7.| |excluded_downtimes|array|[temps d'indisponibilitat SLA exclòs](/manual/api/reference/sla/object#sla-excluded-downtime) que s'ha de crear per a l'SLA.|

en-us	### Parameters  `(object/array)` SLA properties to be updated.  The `slaid` property must be defined for each SLA, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard SLA properties](object#sla), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |service\_tags|array|[SLA service tags](/manual/api/reference/sla/object#sla-service-tag) to replace the current SLA service tags.| |schedule|array|[SLA schedule](/manual/api/reference/sla/object#sla-schedule) to replace the current one.<br><br>Specifying parameter as empty will be interpreted as a 24x7 schedule.| |excluded\_downtimes|array|[SLA excluded downtimes](/manual/api/reference/sla/object#sla-excluded-downtime) to replace the current ones.|
ca	### Parameters  `(objecte/matriu)` propietats SLA que s'han d'actualitzar.  La propietat `slaid` s'ha de definir per a cada SLA; totes les altres propietats són opcionals. Només s'actualitzaran les propietats passades, la resta romandran sense canvis.  A més de les [propietats SLA estàndard](objecte#sla), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |service\_tags|array|[etiquetes de servei SLA](/manual/api/reference/sla/object#sla-service-tag) per substituir les etiquetes de servei SLA actuals.| |schedule|array|[programació SLA](/manual/api/reference/sla/object#sla-schedule) per substituir l'actual.<br><br>Especificar el paràmetre com a buit s'interpretarà com una planificació 24x7.| |excluded\_downtimes|array|[temps d'indisponibilitat d'SLA exclòs](/manual/api/reference/sla/object#sla-excluded-downtime) per substituir els actuals.|

en-us	### Parameters  `(object/array)` Template dashboard properties to be updated.  The `dashboardid` property must be specified for each dashboard, all other properties are optional. Only the specified properties will be updated.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Template dashboard [pages](object#template_dashboard_page) to replace the existing dashboard pages.<br><br>Dashboard pages are updated by the `dashboard_pageid` property. New dashboard pages will be created for objects without `dashboard_pageid` property and the existing dashboard pages will be deleted if not reused. Dashboard pages will be ordered in the same order as specified. Only the specified properties of the dashboard pages will be updated. At least one dashboard page object is required for `pages` property.|
ca	### Paràmetres  `(object/array)` Propietats del tauler a actualitzar.  La propietat `dashboardid` s'ha d'especificar per a cada tauler, totes les altres propietats són opcionals. Només s'actualitzaran les propietats especificades.  A més de les [propietats del tauler de plantilla] estàndard (object#template_dashboard), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |pages|array|[Pàgines del tauler de plantilla](object#template_dashboard_page) substituint les pàgines del tauler de control existents.<br><br>Les pàgines del tauler de control s'actualitzen mitjançant la `propietat dashboard_pageid`. Es crearan pàgines de tauler noves per als objectes sense una propietat `dashboard_pageid` i les pàgines de tauler existents s'esborraran si no es reutilitzen. Les pàgines del tauler s'ordenaran en el mateix ordre especificat. Només s'actualitzaran les propietats especificades de les pàgines del tauler. Es requereix almenys un objecte de pàgina del tauler per a la propietat `pages`.|

en-us	### Parameters  `(object/array)` Template dashboards to create.  Additionally to the [standard template dashboard properties](object#template_dashboard), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |pages|array|Template dashboard [pages](object#dashboard_page) to be created for the dashboard. Dashboard pages will be ordered in the same order as specified.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(objecte/matriu)` Plantilles de tauler de control per crear.  A més de les [propietats del tauler de plantilla] estàndard (object#template_dashboard), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |pages|array|[Pàgines](objecte#dashboard_page) del tauler de control per crear. Les pàgines del tauler de control s'ordenaran en el mateix ordre que s'ha especificat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object/array)` [Template group properties](object#template_group) to be updated.  The `groupid` property must be defined for each template group, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.
ca	### Paràmetres  `(object/array)` [Propietats del grup de plantilles](object#template_group) per actualitzar.  La propietat `groupid` s'ha d'establir per a cada grup de plantilles. La resta de propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

en-us	### Parameters  `(object/array)` Template groups to create. The method accepts template groups with the [standard template group properties](object#template_group).
ca	### Paràmetres  `(object/array)` Grups de plantilles a crear.  El mètode admet els grups de plantilles amb les [propietats estàndard del grup de plantilles](object#template_group).

en-us	### Parameters  `(object/array)` Template properties to be updated.  The `templateid` property must be defined for each template, all other properties are optional. Only the given properties will be updated, all others will remain unchanged.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|[Template groups](/manual/api/reference/templategroup/object) to replace the current template groups the templates belong to.<br><br>The template groups must have the `groupid` property defined.| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag) to replace the current template tags.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given templates.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates. Templates that are not passed are only unlinked.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.|
ca	### Paràmetres  `(object/array)` Propietats de la plantilla a actualitzar.  La propietat `templateid` s'ha d'establir per a cada plantilla, totes les altres propietats són opcionals. Només s'actualitzaran les propietats indicades, les altres romandran sense canvis.  A més de les [propietats de l'objecte del model estàndard](object#model), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|[Grups d'equips](/manual/api/reference/hostgroup/object) substituint els grups d'equips actuals als quals pertanyen les plantilles.<br><br>Els grups d'equips han de tindre la propietat `groupid` establerta. | |tags|object/array|[etiquetes de plantilla](/manual/api/reference/template/object#template_tag) substituint les existents.| |macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) substituint les macros d'usuari actuals en models determinats.| |templates|object/array|[Plantilles](/manual/api/reference/template/object) substituint les plantilles enllaçades actualment. Les plantilles que no es passen només estan desvinculades.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.| |templates\_clear|object/array|[Templates(/manual/api/reference/template/object) per desenllaçar i esborrar les plantilles donades.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|

en-us	### Parameters  `(object/array)` Templates to create.  Additionally to the [standard template properties](object#template), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|[Template groups](/manual/api/reference/templategroup/object) to add the template to.<br><br>The template groups must have the `groupid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |tags|object/array|Template [tags](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Templates](/manual/api/reference/template/object) to be linked to the template.<br><br>The templates must have the `templateid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the template.|
ca	### Paràmetres  `(object/array)` Plantilles a crear.  A més de les [propietats d'objecte de plantilla estàndard] (object#template), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|[Grups de plantilles](/manual/api/reference/templategroup/object) per afegir la plantilla.<br><br>Els grups de plantilles han de tindre el conjunt de propietats `groupid`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |tags|object/array|[Etiquetes de plantilla](/manual/api/reference/template/object#template_tag).| |templates|object/array|[Plantilles](/manual/api/reference/template/object) per associar a la plantilla.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.| |macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) per crear per a la plantilla.|

en-us	### Parameters  `(object/array)` Token properties to be updated.  The `tokenid` property must be defined for each token, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  The method accepts tokens with the [standard token properties](object).
ca	### Paràmetres  `(object/array)` Propietats del token per actualitzar.  La propietat `tokenid` s'ha d'establir per a cada token, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  El mètode admet tokens amb les [propietats estàndard del token](object).

en-us	### Parameters  `(object/array)` Tokens to create.  The method accepts tokens with the [standard token properties](object).
ca	### Paràmetres  `(object/array)` Tokens a crear.  El mètode admet els tokens amb les [propietats estàndard del token](object).

en-us	### Parameters  `(object/array)` Trigger properties to be updated.  The `triggerid` property must be defined for each trigger, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
ca	### Paràmetres  `(object/array)` Propietats del trigger per actualitzar.  La propietat `triggerid` s'ha d'establir per a cada trigger, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats estàndard del trigger] (object#trigger), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dependencies|array|Triggers dels quals depèn el trigger.<br><br>La propietat `triggerid` s'ha d'establir per als triggers.| |tags|array|[Etiquetes de trigger](/manual/api/reference/trigger/object#trigger_tag).|  ::: noteimportant L'expressió de trigger s'ha de donar en la seva forma ampliada. :::

en-us	### Parameters  `(object/array)` Trigger prototype properties to be updated.  The `triggerid` property must be defined for each trigger prototype, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
ca	### Paràmetres  `(object/array)` Propietats del prototip de trigger per actualitzar.  La propietat `triggerid` s'ha d'establir per a cada prototip de trigger, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats estàndard del prototip de trigger] (object#trigger_prototype), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dependencies|array|Triggers i prototips de trigger dels quals depèn el prototip de trigger.<br><br>La propietat `triggerid` s'ha d'establir per als triggers.| |tags|array|[Etiquetes de prototip de trigger](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant L'expressió de trigger s'ha de donar en la seva forma ampliada i ha de contindre almenys un prototip d'element. :::

en-us	### Parameters  `(object/array)` Trigger prototypes to create.  Additionally to the [standard trigger prototype properties](object#trigger_prototype) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers and trigger prototypes that the trigger prototype is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger prototype [tags](/manual/api/reference/triggerprototype/object#trigger_prototype_tag).|  ::: noteimportant The trigger expression has to be given in its expanded form and must contain at least one item prototype. :::
ca	### Paràmetres  `(object/array)` Prototips de triggers a crear.  A més de les [propietats estandard del prototip trigger] (object#trigger_prototype), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dependencies|array|Triggers i prototips de triggers dels quals depèn el prototip de trigger.<br><br>Els triggers han de tindre la propietat `triggerid` establerta.| |tags|array|[Etiquetes](/manual/api/reference/triggerprototype/object#trigger_prototype_tag) del prototip de trigger.|  ::: noteimportant L'expressió trigger s'ha de donar en la seva forma estesa i ha de contindre com a mínim un prototip d'element. :::

en-us	### Parameters  `(object/array)` Triggers to create.  Additionally to the [standard trigger properties](object#trigger) the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dependencies|array|Triggers that the trigger is dependent on.<br><br>The triggers must have the `triggerid` property defined.| |tags|array|Trigger [tags.](/manual/api/reference/trigger/object#trigger_tag)|  ::: noteimportant The trigger expression has to be given in its expanded form. :::
ca	### Paràmetres  `(object/array)` Triggers a crear.  A més de les [propietats estandard del trigger] (object#trigger), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dependencies|array|Triggers dels quals depèn el trigger.<br><br>Els triggers han de tindre la propietat `triggerid` establerta.| |tags|array|[Etiquetes](/manual/api/reference/trigger/object#trigger_tag) del trigger.|  ::: noteimportant L'expressió trigger s'ha de donar en la seva forma extesa. :::

en-us	### Parameters  `(object/array)` User directories to create.  The method accepts user directories with the [standard user directory properties](object#userdirectory).
ca	### Paràmetres  `(object/array)` Directoris d'usuari a crear.  El mètode admet directoris d'usuaris amb les [propietats estàndard de directoris d'usuaris](object#userdirectory).

en-us	### Parameters  `(object/array)` [User directory properties](object#user-directory) to be updated.  The `userdirectoryid` property must be defined for each user directory, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.
ca	### Paràmetres  `(object/array)` [Propietats del directori d'usuaris](objecte#user-directory) per actualitzar.  La propietat `userdirectoryid` s'ha d'establir per a cada directori d'usuaris. La resta de propietats són opcionals. Només s'actualitzaran les propietats donades, totes les altres romandran sense canvis.

en-us	### Parameters  `(object/array)` User group properties to be updated.  The `usrgrpid` property must be defined for each user group, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard user group properties](object#user_group), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostgroup_rights|object/array|Host group [permissions](/manual/api/reference/usergroup/object#permission) to replace the current permissions assigned to the user group.| |templategroup_rights|object/array|Template group [permissions](/manual/api/reference/usergroup/object#permission) to replace the current permissions assigned to the user group.| |tag\_filters|array|[Tag-based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to replace the current permissions assigned to the user group.| |users|object/array|[Users](/manual/api/reference/user/create) to replace the current users assigned to the user group.<br><br>The user must have only the `userid` property defined.| |rights<br>(deprecated)|object/array|This parameter is deprecated, please use `hostgroup_rights` or `templategroup_rights` instead.<br>[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the user group.|
ca	### Paràmetres  `(object/array)` Propietats del grup d'usuaris a actualitzar.  La propietat `usrgrpmid` s'ha d'establir per a cada grup d'usuaris, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats estàndard del grup d'usuaris] (object#user_group), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostgroup_rights|objecte/matriu|[Permisos](/manual/api/reference/usergroup/object#permission) del grup d'equips per substituir els permisos actuals assignats al grup d'usuaris.| |templategroup_rights|objecte/matriu|[Permisos](/manual/api/reference/usergroup/object#permission) del grup de plantilles per substituir els permisos actuals assignats al grup d'usuaris.| |tag\_filters|matriu|[Permisos basats en etiquetes](/manual/api/reference/usergroup/object#tag_based_permission) per substituir els permisos actuals assignats al grup d'usuaris.| |users|objecte/matriu|[Usuaris](/manual/api/reference/user/create) per substituir els usuaris actualment assignats al grup d'usuaris.<br><br>L'usuari ha de tindre definida la propietat `userid`.| |rights<br>(obsolet)|objecte/matriu|Aquest paràmetre és obsolet; si us plau, empreu `hostgroup_rights` o `templategroup_rights`.<br>[Permisos](/manual/api/reference/usergroup/object#permission) per assignar al grup d'usuaris.|

en-us	### Parameters  `(object/array)` User groups to create.  Additionally to the [standard user group properties](object#user_group), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostgroup_rights|object/array|Host group [permissions](/manual/api/reference/usergroup/object#permission) to assign to the user group.| |templategroup_rights|object/array|Template group [permissions](/manual/api/reference/usergroup/object#permission) to assign to the user group.| |tag\_filters|array|[Tag-based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to assign to the user group.| |users|object/array|[Users](/manual/api/reference/user/create) to add to the user group.<br><br>The user must have the `userid` property defined.| |rights<br>(deprecated)|object/array|This parameter is deprecated, please use `hostgroup_rights` or `templategroup_rights` instead.<br>[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the user group.|
ca	### Paràmeters  `(objecte/matriu)` Grups d'usuaris per crear.  A més de les [propietats estàndard del grup d'usuaris](objecte#usuari_grup), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostgroup_rights|objecte/matriu|[Permisos](/manual/api/reference/usergroup/object#permission) del grup d'equips per assignar al grup d'usuaris.| |templategroup_rights|objecte/matriu|Grup de plantilles [permisos](/manual/api/reference/usergroup/object#permission) per assignar al grup d'usuaris.| |tag\_filters|matriu|[Permisos basats en etiquetes](/manual/api/reference/usergroup/object#tag_based_permission) per assignar al grup d'usuaris.| |users|objecte/matriu|[Usuaris](/manual/api/reference/user/create) per afegir al grup d'usuaris.<br><br>L'usuari ha de tindre definida la propietat `identificador d'usuari`.| |rights<br>(obsolet)|objecte/matriu|Aquest paràmetre és obsolet; si us plau, empreu `hostgroup_rights` o `templategroup_rights`.<br>[Permisos](/manual/api/reference/usergroup/object#permission) per assignar al grup d'usuaris.|

en-us	### Parameters  `(object/array)` User properties to be updated.  The `userid` property must be defined for each user, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard user properties](object#user), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |current_passwd|string|User's current password.<br><br>The value of this parameter can be an empty string if the user is linked to a [user directory](/manual/api/reference/userdirectory/object).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *write-only*<br>- *required* if `passwd` of [User object](object#user) is set and user changes own user password| |usrgrps|array|User [groups](/manual/api/reference/user/create) to replace existing user groups.<br><br>The user groups must have the `usrgrpid` property defined.| |medias|array|[User media](/manual/api/reference/user/object#media) to replace existing media.|
ca	### Paràmetres  `(objecte/matriu)` Les propietats d'usuari que s'han d'actualitzar.  La propietat `userid` s'ha de definir per a cada usuari, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.  A més de les [propietats d'usuari estàndard](objecte#usuari), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |current_passwd|cadena|Mot de pas actual de l'usuari.<br><br>El valor d'aquest paràmetre pot ser una cadena buida si:<br>- l'usuari és vinculat a un [directori d'usuari](/manual/api/reference/userdirectory/object);<br>- un usuari del tipus *Superadministrador* és canviant el mot de pas d'un usuari diferent.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *només escriptura*<br>- *obligatori* si `passwd` d'[objecte d'usuari](objecte#usuari) és establert i l'usuari canvia el seu mot de pas| |usrgrps|matriu|[Grups](/manual/api/reference/user/create) d'usuaris per substituir els grups d'usuaris existents.<br><br>Els grups d'usuaris han de tindre la propietat `usrgrpid` definida.| |medias|matriu|[Suports d'usuari](/manual/api/reference/user/object#media) per substituir els suports existents.|

en-us	### Parameters  `(object/array)` Users to create.  Additionally to the [standard user properties](object#user), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |usrgrps|array|User [groups](/manual/api/reference/user/create) to add the user to.<br><br>The user groups must have the `usrgrpid` property defined.| |medias|array|User [media](/manual/api/reference/user/object#media) to be created.|
ca	### Paràmetres  `(object/array)` usuaris a crear.  A més de les [propietats d'usuari estàndard](object#user), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |--|--|------| |usrgrps|array|[Grups d'usuaris](/manual/api/reference/user/create) on afegir l'usuari.<br><br>Els grups d'usuaris han de tindre la propietat `usrgrpid ` definida.| |medias|array|[Suport](/manual/api/reference/user/object#media) d'usuari a crear.|

en-us	### Parameters  `(object/array)` [Value map properties](object#value_map) to be updated.  The `valuemapid` property must be defined for each value map, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.
ca	### Paràmetres  `(object/array)` [Propietats del mapa de valors](objecte#value_map) per actualitzar.  La propietat `valuemapid` s'ha d'establir per a cada mapa de valors. La resta de propietats són opcionals. Només s'actualitzaran les propietats donades, totes les altres romandran sense canvis.

en-us	### Parameters  `(object/array)` Value maps to create.  The method accepts value maps with the [standard value map properties](object#value_map).
ca	### Paràmetres  `(object/array)` Mapes de valors a crear.  El mètode admet els mapes de valors amb les [propietats estàndard dels mapes de valors](object#value_map).

en-us	### Parameters  `(object/array)` Web scenario properties to be updated.  The `httptestid` property must be defined for each web scenario, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Scenario [steps](/manual/api/reference/httptest/object#scenario_step) to replace existing steps.| |tags|array|Web scenario [tags](/manual/api/reference/httptest/object#web_scenario_tag).|
ca	### Paràmetres  `(object/array)` Propietats de l'escenari web per actualitzar.  La propietat `httptestid` s'ha de definir per a cada escenari web; totes les altres propietats són opcionals. Només les propietats transmeses s'actualitzaran; la resta restaran sense canvis.  A més de les [propietats de l'objecte d'escenari web estàndard](object#web_scenario), el mètode accepta els paràmetres següents:  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |steps|array|[Etapes](/manual/api/reference/httptest/object#scenario_step) d'escenari per reemplaçar les ja existents.| |tags|array|[Etiquetes](/manual/api/reference/httptest/object#web_scenario_tag) d'escenari web|

en-us	### Parameters  `(object/array)` Web scenarios to create.  Additionally to the [standard web scenario properties](object#web_scenario), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |steps|array|Web scenario [steps](/manual/api/reference/httptest/object#scenario_step).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |tags|array|Web scenario [tags](/manual/api/reference/httptest/object#web_scenario_tag).|
ca	### Paràmetres  `(object/array)` Escenaris Web a crear.  A més de les [propietats d'escenari web estàndard] (objecte#web_scenario), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |steps|array|[Passes](/manual/api/reference/httptest/object#scenario_step) de l'escenari web.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |tags|array|[Etiquetes](/manual/api/reference/httptest/object#web_scenario_tag) de l'escenari web.|

en-us	### Parameters  `(object)` [Authentication properties](object#authentication) to be updated.
ca	### Paràmetres  `(object)` [Propietats d'autenticació](object#authentication) que s'actualitzaran.

en-us	### Parameters  `(object)` [Autoregistration properties](object#autoregistration) to be updated.
ca	### Paràmetres  `(object)` [Propietats d'autoregistre](object#autoregistration) que s'actualitzaran.

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

en-us	### Parameters  `(object)` Parameters containing the data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |format|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |source|string|Serialized string containing the configuration data.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |rules|object|Rules on how new and existing objects should be imported.<br><br>The `rules` parameter is described in detail in the table below.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|  ::: notetip If no rules are given, the configuration will not be updated. :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |host_groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |template_groups|object|Rules on how to import template groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, templates that are not linked to the host or template being imported, but are present in the imported data, will be linked; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, templates that are linked to the host or template being imported, but are not present in the imported data, will be unlinked without removing entities (items, triggers, etc.) inherited from the unlinked templates; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
ca	### Paràmetres  `(object)` Els paràmetres que contenen la informació a importar i les regles sobre com s'ha de gestionar aquesta informació.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**format**<br>(obligatori)|string|Format de la cadena en sèrie.<br><br>Valors possibles:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(obligatori)|string|Cadena en sèrie que conté la informació de configuració.| |**rules**<br>(obligatori)|object|Regles sobre com s'han d'importar els objectes nous i existents.<br><br>el paràmetre `rules` es descriu en detall a la taula de sota.|  ::: notetip Si no es donen regles, la configuració no s'actualitzarà pas. :::  L'objecte `rules` admet els següents paràmetres:  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |discoveryRules|object|Regles sobre com importar les regles LLD.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan noves regles LLD; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, les regles LLD s'actualitzaran; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, les regles LLD que no siguin a la informació importada s'esborrarà de la base de dades; per defecte: `false`.| |graphs|object|Regles sobre importació de gràfics.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan els nous gràfics; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els gràfics existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els gràfics que no siguin pas a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |groups|object|Regles sobre importar grups d'equips.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan nous grups d'equips; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els grups d'equips existents; per defecte: `false`.| |hosts|object|Regles d'importació d'equips.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan els nous equips; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els equips existents; per defecte: `false`.| |httptests|object|Regles d'importació d'escenaris web.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan els nous escenaris web; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els escenaris web existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els escenaris web que no siguin pas a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |images|object|Regles sobre importació d'imatges.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan les noves imatges; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran les imatges existents; per defecte: `false`.| |items|object|Regles d'importació d'elements.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan els nous elements; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els elements existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els elements que no siguin pas presents a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |maps|object|Regles d'importació de mapes.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan els nous mapes; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, existing maps will be updated; per defecte: `false`.| |mediaTypus|object|Regles d'importació de  tipus de suport.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan nous tipus de suport; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els tipus de suport existents; per defecte: `false`.| |templateLinkage|object|Regles d'importació d'enllaços de plantilles.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan nous enllaços entre plantilles i equips; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els enllaços de plantilles que no siguin pas a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |templates|object|Rules on how to import templates.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan noves plantilles; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran les plantilles existents; per defecte: `false`.| |templateDashboards|object|Regles d'importació de taulers de plantilles.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan nous taulers de plantilles; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els taulers de plantilles existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els taulers de plantilles que no siguin pas a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |triggers|object|Regles d'importació de triggers.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan nous triggers; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els triggers existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els triggers que no siguin pas a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |valueMaps|object|Regles d'importació d'equips o mapes de correspondència.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` Si s'estableix a `true`, es crearan nous mapes de correspondència; per defecte: `false`;<br>`updateExisting` - `(boolean)` Si s'estableix a `true`, s'actualitzaran els mapes de correspondència; per defecte: `false`;<br>`deleteMissing` - `(boolean)` Si s'estableix a `true`, els mapes de correspondència que no siguin a la informació importada s'esborraran de la base de dades; per defecte: `false`.|

en-us	### Parameters  `(object)` Parameters containing the host interfaces to be created on the given hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to create on the given hosts.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hosts|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen les interfícies de l'equip per crear als equips donats.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |interfaces|object/array|[Interfícies d'equip](/manual/api/reference/hostinterface/object) per crear als equips donats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |hosts|object/array|Equips a actualitzar.<br><br>Els equips han de tindre la propietat `hostid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters containing the ID of the host to be updated and the new host interfaces.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces with.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hostid|string|ID of the host to be updated.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen l'ID de l'equip a actualitzar i les noves interfícies d'equip.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |interfícies|object/array|[Interfícies d'equips](/manual/api/reference/hostinterface/object) per substituir les interfícies d'equip actuals.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |hostid|cadena|ID d'equip per actualitzar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters containing the ID of the script to run and either the ID of the host or the ID of the event.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |scriptid|string|ID of the script to run.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hostid|string|ID of the host to run the script on.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `eventid` is not set| |eventid|string|ID of the event to run the script on.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `hostid` is not set|
ca	### Paràmetres  `(object)` Paràmetres que contenen l'ID de l'script a executar i l'ID de l'equip o l'ID de l'esdeveniment.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |scriptid|cadena|ID de l'script a executar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |hostid|string|ID de l'equip on executar l'script.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si no s'ha definit `eventid`| |eventid|string|ID de l'esdeveniment on executar l'script.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si no s'ha definit pas `hostid`|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|IDs of the host groups to be updated.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hostids|string/array|Hosts to remove from all host groups.|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels grups d'equips a actualitzar i objectes a esborrar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|cadena/matriu|ID dels grups d'equips a actualitzar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |hostids|string/array|Equips per eliminar de tots els grups d'equips.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects that should be updated.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hosts|object/array|Hosts to replace the current hosts on the given host groups.<br>All other hosts, except the ones mentioned, will be excluded from host groups.<br>Discovered hosts will not be affected.<br><br>The hosts must have the `hostid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels grups d'equips i objectes a actualitzar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|Grups d'equips per actualitzar.<br>Tots els altres equips excepte els esmentats seran exclosos dels grups d'equips. <br>Els equips descoberts no es veuran afectats.< br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |hosts|object/array|Equips que substitueixen els equips actuals en grups d'equips determinats.<br><br>Els equips han de tindre la propietat `hostid` establerta.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the host groups to update and the objects to add to all the host groups.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Host groups to be updated.<br><br>The host groups must have the `groupid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hosts|object/array|Hosts to add to all host groups.<br><br>The hosts must have the `hostid` property defined.|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels grups d'equips que cal actualitzar i els objectes que cal afegir a tots els grups d'equips.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|Grups d'equips per actualitzar.<br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |hosts|object/array|Equips per afegir a tots els grups d'equips.<br><br>Els equips han de tindre la propietat `hostid` establerta.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to be updated and the interfaces to be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |hostids|string/array|IDs of the hosts to be updated.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels equips que cal actualitzar i les interfícies que cal esborrar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostids|string/array|ID dels equips a actualitzar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |interfícies|object/array|Interfícies de l'equip que s'han d'esborrar dels equips especificats.<br><br>L'objecte de la interfície de l'equip ha de tindre les propietats ip, dns i port configurades.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostids|string/array|IDs of the hosts to be updated.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |groupids|string/array|Host groups to remove the given hosts from.| |interfaces|object/array|Host interfaces to remove from the given hosts.<br><br>The host interface object must have the `ip`, `dns` and `port` properties defined.| |macros|string/array|User macros to delete from the given hosts.| |templateids|string/array|Templates to unlink from the given hosts.| |templateids\_clear|string/array|Templates to unlink and clear from the given hosts.|
ca	### Paràmetres  `(object)` Paràmetres que contenen els identificadors d'equips a actualitzar i objectes a esborrar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostids|string/array|ID dels equips a actualitzar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |groupids|string/array|Grups d'equips dels quals esborrar els equips donats.| |interfícies|objecte/array|Interfícies de l'equip que s'han d'esborrar dels equips donats.<br><br>L'objecte de la interfície de l'equip ha de tindre les propietats `ip`, `dns` i `port` configurades.| |macros|string/array|Macros d'usuari per esborrar dels equips donats.| |templateids|string/array|Plantilles per desenllaçar dels equips donats.| |templateids\_clear|string/array|Plantilles per desenllaçar i esborrar els equips donats.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the objects to add to all the hosts.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|object/array|Hosts to be updated.<br><br>The hosts must have the `hostid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |groups|object/array|Host groups to add to the given hosts.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|[Host interfaces](/manual/api/reference/hostinterface/object) to be created for the given hosts.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given hosts.| |templates|object/array|Templates to link to the given hosts.<br><br>The templates must have the `templateid` property defined.|
ca	### Paràmetres  `(object)` Paràmetres que contenen ID d'equip per actualitzar i objectes per afegir a tots els equips.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |equips|object/array|Equips a actualitzar.<br><br>Els equips han de tindre la propietat `hostid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |grups|object/array|Grups d'equips per afegir als equips donats.<br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.| |interfícies|object/array|[Interfícies d'equip](/manual/api/reference/hostinterface/object) per crear per als equips donats.| |macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) per crear per als equips donats.| |plantilles|object/array|Plantilles per enllaçar amb els equips donats.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the hosts to update and the properties that should be updated.  Additionally to the [standard host properties](object#host), the method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hosts|object/array|[Hosts](/manual/api/reference/host/object) to be updated.<br><br>The hosts must have the `hostid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |groups|object/array|Host [groups](/manual/api/reference/hostgroup/object) to replace the current host groups the hosts belong to.<br><br>The host groups must have the `groupid` property defined.| |interfaces|object/array|Host [interfaces](/manual/api/reference/hostinterface/object) to replace the current host interfaces on the given hosts.| |inventory|object|Host [inventory](/manual/api/reference/host/object#host_inventory) properties.<br><br>Host inventory mode cannot be updated using the `inventory` parameter, use `inventory_mode` instead.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace the current user macros on the given hosts.| |templates|object/array|[Templates](/manual/api/reference/template/object) to replace the currently linked templates on the given hosts.<br><br>The templates must have the `templateid` property defined.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) to unlink and clear from the given hosts.<br><br>The templates must have the `templateid` property defined.|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID d'equip que cal actualitzar i les propietats que cal actualitzar.  A més de les [propietats de l'objecte equip estàndard] (objecte#host), el mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hosts|object/array|[Equips](/manual/api/reference/host/object) per actualitzar.<br><br>Els equips han de tindre la propietat `hostid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |groups|object/array|[Grups d'equips](/manual/api/reference/hostgroup/object) substituint els grups d'equips actuals als quals pertanyen els equips.<br><br>Els equips han de tindre definida la propietat `groupid`.| |interfaces|object/array|[Interfícies d'equip](/manual/api/reference/hostinterface/object) substituint les interfícies d'equip actuals als equips donats.| |inventory|object|Les propietats d'[inventari de l'equip](/manual/api/reference/host/object#host_inventory).<br><br>El mode d'inventari de l'equip no es pot pas definir actualitzat mitjançant el paràmetre `inventory`; empreu `inventory_mode` en canvi.| |macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) substituint les macros d'usuari actuals als equips determinats.| |templates|object/array|[Plantilles](/manual/api/reference/template/object) que substitueixen les plantilles enllaçades actualment als equips donats.<br><br>Les plantilles han de tindre la propietat `templateid` definida. |templates\_clear|object/array|[Plantilles](/manual/api/reference/template/object) per desenllaçar i esborrar els equips donats.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the template groups to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupids|string/array|IDs of the template groups to be updated.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |templateids|string/array|Templates to remove from all template groups.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels grups de plantilles a actualitzar i objectes a esborrar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|cadena/matriu|ID dels grups de plantilles a actualitzar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |templateids|string/array|Plantilles per eliminar de tots els grups de plantilles.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters containing the IDs of the template groups to update and the objects that should be updated.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Template groups to be updated.<br><br>The template groups must have the `groupid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |templates|object/array|Templates to replace the current template on the given template groups.<br>All other template, except the ones mentioned, will be excluded from template groups.<br><br>The templates must have the `templateid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels grups de plantilles i objectes a actualitzar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|Grups de plantilles per actualitzar.<br>Tots els altres equips excepte els esmentats seran exclosos dels grups de plantilles. <br>Els equips descoberts no es veuran afectats.< br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |template|object/array|Plantillesque substitueixen les plantilles actuals en grups de plantilles determinats.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters containing the IDs of the template groups to update and the objects to add to all the template groups.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groups|object/array|Template groups to be updated.<br><br>The template groups must have the `groupid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |templates|object/array|Templates to add to all template groups.<br><br>The templates must have the `templateid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|
ca	### Paràmetres  `(object)` Paràmetres que contenen els ID dels grups de plantilles i els objectes a afegir a tots els grups de plantilles.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groups|object/array|Grups de plantilles per actualitzar.<br>Tots els altres equips excepte els esmentats seran exclosos dels grups de plantilles. <br>Els equips descoberts no es veuran afectats.< br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |templates|object/array|Plantilles per afegir a tots els grups de plantilles.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects that should be removed.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |templateids|string/array|IDs of the templates to be updated.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |groupids|string/array|[Template groups](/manual/api/reference/templategroup/object) from which to remove the given templates.| |macros|string/array|[User macros](/manual/api/reference/usermacro/object) to delete from the given templates.| |templateids\_clear|string/array|Templates to unlink and clear from the given templates (upstream).| |templateids\_link|string/array|Templates to unlink from the given templates (upstream).|
ca	### Paràmetres  `(object)` Paràmetres que contenen els identificadors dels models a actualitzar i els objectes a esborrar.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |templateids|string/array|ID de les plantilles a actualitzar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |groupids|string/array|[Grups de plantilles](/manual/api/reference/templategroup/object) d'on esborrar les plantilles donades.| |macros|string/array|[Macros d'usuari](/manual/api/reference/usermacro/object) per esborrar de les plantilles donades.| |templateids\_clear|string/array|Plantilles per desenllaçar i esborrar plantilles donades (upstream).| |templateids\_link|string/array|Plantilles per desenllaçar de les plantilles donades (upstream).|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to add to the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |templates|object/array|Templates to be updated.<br><br>The templates must have the `templateid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |groups|object/array|[Template groups](/manual/api/reference/templategroup/object) to add the given templates to.<br><br>The template groups must have the `groupid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to be created for the given templates.| |templates\_link|object/array|Templates to link to the given templates.<br><br>The templates must have the `templateid` property defined.|
ca	### Paràmetres  `(object)` Paràmetres que contenen els identificadors dels models a actualitzar i els objectes a afegir als models.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |templates|object/array|Plantilles per actualitzar.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |groups|object/array|[Grups de plantilles](/manual/api/reference/templategroup/object) on afegir les plantilles donades.<br><br>Els grups de plantilles han de tindre definida la propietat  `groupid`.| |macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object)  per crear per a plantilles determinades.| |templates\_link|object/array|Plantilles per enllaçar a les plantilles donades.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|

en-us	### Parameters  `(object)` Parameters containing the IDs of the templates to update and the objects to replace for the templates.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |templates|object/array|[Templates](/manual/api/reference/template/object) to be updated.<br><br>The templates must have the `templateid` property defined.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |groups|object/array|[Template groups](/manual/api/reference/templategroup/object) to replace the current template groups the templates belong to.<br><br>The template groups must have the `groupid` property defined.| |macros|object/array|[User macros](/manual/api/reference/usermacro/object) to replace all of the current user macros on the given templates.| |templates\_clear|object/array|Templates to unlink and clear from the given templates.<br><br>The templates must have the `templateid` property defined.| |templates\_link|object/array|Templates to replace the currently linked templates.<br><br>The templates must have the `templateid` property defined.|
ca	### Paràmetres  `(object)` Paràmetres que contenen els identificadors dels models a actualitzar i les propietats a actualitzar.  El mètode accepta els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |templates|object/array|[Plantilles](/manual/api/reference/template/object) per actualitzar.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |groups|object/array|[Grups de plantilles](/manual/api/reference/templategroup/object) per substituir els grups de plantilles actuals als quals pertanyen les plantilles.<br><br>Els grups d'equips han de tindre la propietat `groupid` establerta.| |macros|object/array|[Macros d'usuari](/manual/api/reference/usermacro/object) per substituir les macros d'usuari actuals en models determinats.| |templates\_clear|object/array|Plantilles per desenllaçar i esborrar les plantilles donades.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.| |templates\_link|object/array|Plantilles que substitueixen les plantilles enllaçades actualment.<br><br>Les plantilles han de tindre la propietat `templateid` establerta.|

en-us	### Parameters  `(object)` Parameters containing the possible data to import and rules how the data should be handled.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |format|string|Format of the serialized string.<br><br>Possible values:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |source|string|Serialized string containing the configuration data.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |rules|object|Rules on how new and existing objects should be compared.<br><br>The `rules` parameter is described in detail in the table below.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|  ::: notetip If no rules are given, there will be nothing to update and result will be empty. :::  ::: notetip Comparison will be done only for host groups and templates. Triggers and graphs will be compared only for imported templates, any other will be considered as "new". :::  The `rules` object supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |discoveryRules|object|Rules on how to import LLD rules.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new LLD rules will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing LLD rules will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, LLD rules not present in the imported data will be deleted from the database; default: `false`.| |graphs|object|Rules on how to import graphs.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new graphs will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing graphs will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, graphs not present in the imported data will be deleted from the database; default: `false`.| |host_groups|object|Rules on how to import host groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new host groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing host groups will be updated; default: `false`.| |template_groups|object|Rules on how to import template groups.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template groups will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template groups will be updated; default: `false`.| |hosts|object|Rules on how to import hosts.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new hosts will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing hosts will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |httptests|object|Rules on how to import web scenarios.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new web scenarios will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing web scenarios will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, web scenarios not present in the imported data will be deleted from the database; default: `false`.| |images|object|Rules on how to import images.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new images will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing images will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |items|object|Rules on how to import items.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new items will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing items will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, items not present in the imported data will be deleted from the database; default: `false`.| |maps|object|Rules on how to import maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing maps will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |mediaTypes|object|Rules on how to import media types.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new media types will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing media types will be updated; default: `false`.<br><br>This parameter will make no difference to the output. It is allowed only for consistency with `configuration.import`.| |templateLinkage|object|Rules on how to import template links.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, templates that are not linked to the host or template being imported, but are present in the imported data, will be linked; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, templates that are linked to the host or template being imported, but are not present in the imported data, will be unlinked without removing entities (items, triggers, etc.) inherited from the unlinked templates; default: `false`.| |templates|object|Rules on how to import templates.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new templates will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing templates will be updated; default: `false`.| |templateDashboards|object|Rules on how to import template dashboards.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new template dashboards will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing template dashboards will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, template dashboards not present in the imported data will be deleted from the database; default: `false`.| |triggers|object|Rules on how to import triggers.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new triggers will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing triggers will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, triggers not present in the imported data will be deleted from the database; default: `false`.| |valueMaps|object|Rules on how to import host or template value maps.<br><br>Supported parameters:<br>`createMissing` - `(boolean)` if set to `true`, new value maps will be created; default: `false`;<br>`updateExisting` - `(boolean)` if set to `true`, existing value maps will be updated; default: `false`;<br>`deleteMissing` - `(boolean)` if set to `true`, value maps not present in the imported data will be deleted from the database; default: `false`.|
ca	### Paràmetres  `(object)` Paràmetres que contenen les dades possibles a importar i les regles de tractament de les dades.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**format**<br>(obligatori)|string|Format de la cadena serialitzada.<br><br>Valors possibles:<br>`yaml` - YAML;<br>`xml` - XML;<br>`json` - JSON.| |**source**<br>(obligatori)|string|Cadena serialitzada continguent la informació de configuració.| |**rules**<br>(obligatori)|object|regles sobre com s'han d'importar els nous i existents objectes. <br><br>El paràmetre `rules` es descriu en detall a la taula de sota.|  ::: notetip Si no es donen regles, no hi haurà pas res a actualitzar; i el resultat serà buit. :::   ::: notetip La comparació es farà només per a grups d'equips i plantilles. Els triggers i gràfics es compararan només per a les plantilles importades; qualsevol altra es considerarà com a nova. :::  L'objecte `rules` admet els paràmetres següents:  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |discoveryRules|object|Regles sobre com importar les regles LLD.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan noves regles LLD; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, les regles LLD existents s'actualitzaran; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, les regles LLD que no són pas presents a la informació importada s'esborrarà de la base de dades; per defecte: `false`.| |graphs|object|Regles sobre importació de gràfics.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan nous gràfics; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, els gràfics existents s'actualitzaran; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, els gràfics que no són pas presents a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |groups|object|Regles sobre importació de grups d'equips.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, els nous grups d'equips es crearan; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, els grups d'equips existents s'actualitzaran; per defecte: `false`.| |hosts|object|Regles sobre importació d'equips.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, els nous equips es crearan; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, els equips existents s'actualitzaran; per defecte: `false`.<br><br>Aquest paràmetre no modificarà pas la sortida. És disponible només per consistència amb `configuration.import`.| |httptests|object|Regles sobre importació d'escenaris web.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, els nous escenaris web es crearan; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, els escenaris web existents s'actualitzaran; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, els escenaris web no presents a la informació importada seran esborrats de la base de dades; per defecte: `false`.| |images|object|Regles sobre importació d'imatges.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan les noves imatges; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, les imatges existents s'actualitzaran; per defecte: `false`.<br><br>Aquest paràmetre no modificarà pas la sortida. Només és habilitat per consistència amb `configuration.import`.| |items|object|Regles sobre importació de nous elements.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan els nous elements; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, s'actualitzaran els elements existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, els elements que no són presents a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |maps|object|Regles sobre importació de mapes.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan els nous mapes; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, s'actualitzaran els mapes existents; per defecte: `false`.<br><br>Aquest paràmetre no modificarà pas la sortida. Només és habilitat per consistència amb `configuration.import`.| |mediaTypes|object|regles sobre importació de tipus de suport.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan els nous tipus de suport; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, s'actualitzaran els tipus de suport existents; per defecte: `false`.<br><br>Aquest paràmetre no modificarà pas la sortida. Només és habilitat per consistència amb `configuration.import`.| |templateLinkage|object|Regles sobre importació de plantilles d'enllaços.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan els nous enllaços entre plantilles; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, els enllaços entre plantilles que no siguin presents a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |templates|object|Regles sobre importació de plantilles.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan les noves plantilles; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, les plantilles existents s'actualitzaran; per defecte: `false`.| |templateDashboards|object|Regles sobre importació dels taulers de plantilles.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan els nous taulers de plantilles; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, s'actualitzaran els taulers de plantilles existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, els taulers de plantilles no existents a la informació importada s'esborraran de la base de dades; per defecte: `false`.| |triggers|object|Regles sobre importació de triggers.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan els nous triggers; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, s'actualitzaran els triggers existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, els triggers no existents a la informació importada s'esborrarà de la base de dades; per defecte: `false`.| |valueMaps|object|Regles sobre importació d'equips o plantilles de correspondència.<br><br>Paràmetres admesos:<br>`createMissing` - `(boolean)` si s'estableix a `true`, es crearan les noves plantilles de correspondència; per defecte: `false`;<br>`updateExisting` - `(boolean)` si s'estableix a `true`, s'actualitzaran les plantilles de correspondència existents; per defecte: `false`;<br>`deleteMissing` - `(boolean)` si s'estableix a `true`, les plantilles de correspondència que no són pas presents a la informació importada s'esborrarà de la base de dades; per defecte: `false`.|

en-us	### Parameters  `(object)` Parameters containing the SLA ID, reporting periods and, optionally, the IDs of the services - to calculate the SLI for.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |slaid|string|ID of the SLA to return availability information for.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |period\_from|timestamp|Starting date (inclusive) to report the SLI for.<br><br>Possible values: timestamp.| |period\_to|timestamp|Ending date (exclusive) to report the SLI for.<br><br>Possible values: timestamp.| |periods|array|Preferred number of periods to report.<br><br>Possible values: 1-100| |serviceids|string/array|IDs of services to return the SLI for.|
ca	### Paràmetres  `(objecte)` Paràmetres que contenen l'ID de l'SLA, els períodes d'informe i, opcionalment, els ID dels serveis - emprats per calcular l'SLI.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |slaid|string|IDs dels serveis per als quals retornar informació de disponibilitat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |period\_from|timestamp|Data d'inici (inclosa) per a informar l'SLI.<br><br>Valor possible: marca de temps.| |period\_to|timestamp|Data de finalització (exclusiva) per a la qual es notifica l'SLI.<br><br>Valor possible: marca de temps.| |periods|matriu|Nombre preferit de períodes per informar.<br><br>Valors possibles: 1-100| |serviceids|string/array|ID dels serveis per als quals retornar l'SLI.|

en-us	### Parameters  `(object)` Parameters containing the user name and password.  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |password|string|User password.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |username|string|User name.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |userData|flag|Return information about the authenticated user.|
ca	### Paràmetres  `(object)` Paràmetres que contenen nom d'usuari i mot de pas.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |--|--|------| |password|string|mot de pas de l'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |username|string|Nom d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |userData|flag|Retorna informació de l'usuari autenticat.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
ca	### Paràmetres  `(object)` Paràmetres definint la sortida esperada.  El mètode accepta només un paràmetre.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |output|query|Aquest paràmetre és comú per a tots els mètodes `get` descrits al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
ca	### Paràmetres  `(object)` Paràmetres definint la sortida esperada.  El mètode accepta només un paràmetre.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |output|query|Aquest paràmetre és comú per a tots els mètodes `get` descrits al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
ca	### Paràmetres  `(object)` Paràmetres definint la sortida esperada.  El mètode accepta només un paràmetre.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |output|query|Aquest paràmetre és comú per a tots els mètodes `get` descrits al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports only one parameter.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |output|query|This parameter being common for all `get` methods described in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).|
ca	### Paràmetres  `(object)` Paràmetres definint la sortida esperada.  El mètode accepta només un paràmetre.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |output|query|Aquest paràmetre és comú per a tots els mètodes `get` descrits al [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionids|string/array|Return only actions with the given IDs.| |groupids|string/array|Return only actions that use the given host groups in action conditions.| |hostids|string/array|Return only actions that use the given hosts in action conditions.| |triggerids|string/array|Return only actions that use the given triggers in action conditions.| |mediatypeids|string/array|Return only actions that use the given media types to send messages.| |usrgrpids|string/array|Return only actions that are configured to send messages to the given user groups.| |userids|string/array|Return only actions that are configured to send messages to the given users.| |scriptids|string/array|Return only actions that are configured to run the given scripts.| |selectFilter|query|Return a [filter](/manual/api/reference/action/object#action_filter) property with the action condition filter.| |selectOperations|query|Return an [operations](/manual/api/reference/action/object#action_operation) property with action operations.| |selectRecoveryOperations|query|Return a [recovery\_operations](/manual/api/reference/action/object#action_recovery_operation) property with action recovery operations.| |selectUpdateOperations|query|Return an [update\_operations](/manual/api/reference/action/object#action_update_operation) property with action update operations.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `actionid`, `name`, `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).| |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.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |actionids|string/array|Retorna només les accions amb els IDs esmentats.| |groupids|string/array|Retorna només les accions que inclouen a les seves condicions d'acció els grups d'equips esmentats.| |hostids|string/array|Retorna només les accions que inclouen a les seves condicions d'acció els equips esmentats.| |triggerids|string/array|Retorna només les accions que inclouen a les seves condicions els triggers esmentats.| |mediatypeids|string/array|Retorna només les accions que fan ús dels tipus de medi esmentats per enviar missatges.| |usrgrpids|string/array|Retorna només les accions configurades per a enviar missatges als grups d'usuaris esmentats.| |userids|string/array|Retorna només les accions configurades per a enviar missatges als usuaris esmentats.| |scriptids|string/array|Retorna només les accions configurades per a executar els scripts esmentats.| |selectFilter|query|Retorna una propietat de [filtre](/manual/api/reference/action/object#action_filter) amb el filtre de condició d'acció.| |selectOperations|query|Retorna una propietat d'[operacions](/manual/api/reference/action/object#action_operation) amb operacions d'acció.| |selectRecoveryOperations|query| Retorna una propietat de [recovery\_operations](/manual/api/reference/action/object#action_recovery_operation) amb operacions de recuperació.| |selectUpdateOperations|query|Retorna una propietat d'[update\_operations](/manual/api/reference/action/object#action_update_operation) amb operacions d'actualització.| |sortfield|string/array|Ordena els resultats per les propietats esmentades..<br><br>Els possibles valors són: `actionid`, `name` i `status`.| |countOutput|boolean|Aquests paràmetres són comuns per a tots els mètodes `get` descrits a [comentari de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |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 or templates from the host groups or template groups with the given name.| |groupids|string/array|Return only trigger prototypes that belong to hosts or templates from the given host groups or template 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.| |selectHostGroups|query|Return the host groups that the trigger prototype belongs to in the [hostgroups](/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.| |selectTemplateGroups|query|Return the template groups that the trigger prototype belongs to in the [templategroups](/manual/api/reference/templategroup/object) 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: `triggerid`, `description`, `status`, `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|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` or `selectTemplateGroups` instead.<br>Return the host groups and template groups that the trigger prototype belongs to in the `groups` property.|
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.| |selectHostGroups|query|Retorna els grups d'equips als quals pertany el prototip del trigger a la propietat [hostgroups](/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).| |selectTemplateGroups|query|Retorna els grups de plantilles als quals pertany el prototip del trigger a la propietat [templategroups](/manual/api/reference/templategroup/object).| |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|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si us plau, emprau `selectHostGroups` o `selectTemplateGroups` en el seu lloc.<br>Retorna els grups d'equips i els grups de plantilles on el trigger pertany a la propietat `groups`.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |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: `alertid`, `clock`, `eventid`, `mediatypeid`, `sendto`, `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'esdeveniment ["source"](/manual/api/reference/event/object#event) per obtindre una llista dels tipus d'events suportats.<br><br>Per defecte: 0 - esdeveniments 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: `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 que defineixen la sortida esperada.  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |auditids|cadena/matriu|Retorna només el registre d'auditoria amb els ID donats.| |userids|cadena/matriu|Retorna només el registre d'auditoria creat pels usuaris donats.| |time\_from|timestamp|Retorna només les entrades del registre d'auditoria que s'han creat després o en el moment donat.| |time\_till|timestamp|Retorna només les entrades del registre d'auditoria que s'han creat abans o en el moment donat.| |sortfield|cadena/matriu|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `auditid`, `userid`, `clock`.| |filter|objecte|Retorna només els resultats que coincideixen exactament amb el filtre donat.<br><br>Admet una matriu, on les claus són noms de propietats i els valors són un valor únic o una matriu de valors amb els quals coincideix.| |search|objecte|Cerca de subcadenes que no distingeix entre majúscules i minúscules al contingut dels camps: `nom d'usuari`, `ip`, `nom del recurs`, `detalls`.| |countOutput|boolean|Aquests paràmetres, comuns a tots els mètodes `get`, es descriuen als [comentaris de referència](/manual/api/reference_commentary#common_get_method_parameters).| |excludeSearch|boolean|^| |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| |--|--|------| |connectorids|string/array|Return only connectors with the given IDs.| |selectTags|query|Return a `tags` property with connector [tag filter](/manual/api/reference/connector/object#tag-filter).<br><br>Supports `count`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `connectorid`, `name`, `data_type`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |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ó| |--|--|------| |connectorids|string/array|Retorna només connectors amb els identificadors donats.| |selectTags|query|Retorna una propietat `tags` amb el [filtre d'etiqueta](/manual/api/reference/connector/object#tag-filter) del connector.<br><br>Admet `count`.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `connectorid`, `name`, `data_type`, `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).| |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| |--|--|------| |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: `correlationid`, `name`, `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  `(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ó| |--|--|------| |correlationids|string/array|Retorna només correlacions amb els identificadors donats.| |selectFilter|query|Retorna una propietat [filtre](/manual/api/reference/correlation/object#correlation_filter) amb la correlació de condicions.| |selectOperations|query|Retorna una propietat  [operacions](/manual/api/reference/correlation/object#correlation_operation) amb la correlació de condicions.| |sortfield|string/array|Ordena el resultat segons les propietats donades.<br><br>Els valors possibles són: `rcorrelationid`, `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| |--|--|------| |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 values: `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: `dashboardid`, `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: `dcheckid`, `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: `dhostid`, `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: `druleid`, `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 or templates in the given host groups or template 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.| |selectHostGroups|query|Return a [hostgroups](/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.| |selectTemplateGroups|query|Return a [templategroups](/manual/api/reference/templategroup/object) property with the template groups that the graph prototype belongs to.| |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: `graphid`, `name`, `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|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` or `selectTemplateGroups` instead.<br>Return a `groups` property with the host groups and template groups that the graph prototype belongs to.|
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.| |templated|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 .| |selectTemplateGroups|query|Retorna una propietat [templategroups](/manual/api/reference/templategroup/object) amb els grups de plantilles a les quals pertany el prototip de gràfic.| |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|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; empreu en el seu lloc `selectHostGroups` o `selectTemplateGroups`.<br>Retorna la propietat `grups` amb els grups d'equips i grups de plantilles on el gràfic pertany.|

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;<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>28 - SNMP walk value;<br>29 - SNMP walk to JSON.<br>`params` - `(string)` Additional parameters used by preprocessing option. Multiple parameters are separated by the newline (\\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>`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: `itemid`, `name`, `key_`, `delay`, `type`, `status`.| |countOutput|boolean|These parameters being common for all `get` methods are described in detail in the [reference commentary](/manual/api/reference_commentary#common_get_method_parameters).| |editable|boolean|^| |excludeSearch|boolean|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^|
ca	### Paràmetres  `(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.| |templated|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 - 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>28 - Valor SNMP walk;<29> - SNMP walk a JSON.<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|^| |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: `dserviceid`, `dhostid`, `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|Retorna 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.| |symptom|boolean|`true` - return only symptom events;<br>`false` - return only cause events.| |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>`suppress_until` - `(timestamp)` time till event will be suppressed;<br>`taskid` - `(string)` ID of task if current event is undergoing a rank change;<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 active maintenances and manual suppressions:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`userid` - `(string)` ID of user who suppressed the event;<br>`suppress_until` - `(integer)` time until the event is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `eventid`, `objectid`, `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.| |symptom|boolean|`cert` - retorna només els esdeveniments simptomàtics;<br>`fals` - retorna només els esdeveniments causa.| |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.| |symptom|boolean|`true` - return only symptom problem events;<br>`false` - return only cause problem events.| |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>`suppress_until` - `(timestamp)` time till event will be suppressed;<br>`taskid` - `(string)` ID of task if current event is undergoing a rank change;<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 active maintenances and manual suppressions:<br>`maintenanceid` - `(string)` ID of the maintenance;<br>`userid` - `(string)` ID of user who suppressed the problem;<br>`suppress_until` - `(integer)` time until the problem is suppressed.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `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.| |symptom|boolean|`true` - només retorna esdeveniments de símptomes;<br>`false` - retorna només esdeveniments de causes.| |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 or template 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.| |selectHostGroups|query|Return host groups that the host macro belongs to in the [hostgroups](/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.| |selectTemplateGroups|query|Return template groups that the template macro belongs to in the [templategroups](/manual/api/reference/templategroup/object) property.<br><br>Used only when retrieving template 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 values: `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|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` or `selectTemplateGroups` instead.<br>Return host groups and template groups that the host macro belongs to in the `groups` property.<br><br>Used only when retrieving host macros.|
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.| |selectHostGroups|query|Retorna els grups d'equips als quals pertany la macro de l'equip a la propietat [hostgroups](/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.| |selectTemplateGroups|query|Retorna els grups d'equips als quals pertany la macro de l'equip a la propietat [templategroups](/manual/api/reference/templategroup/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|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si us plau, emprau `selectHostGroups` o `selectTemplateGroups` en el seu lloc.<br>Retorna els grups d'equips i els grups de plantilles on el trigger pertany a la propietat `groups`.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |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: `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 or templates in the given host groups or template 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.| |selectHostGroups|query|Return a [hostgroups](/manual/api/reference/hostgroup/object) property with the host groups that the graph belongs to.| |selectTemplateGroups|query|Return a [templategroups](/manual/api/reference/templategroup/object) property with the template 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: `graphid`, `name`, `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|^| |selectGroups<br> (deprecated)|query|This parameter is deprecated, please use `selectHostGroups` or `selectTemplateGroups` instead.<br> Return a `groups` property with the host groups and template groups that the graph belongs to.|
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.| |templated|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.| |selectHostGroups|query|Retorna la propietat [grups d'equips](/manual/api/reference/hostgroup/object) amb els grups d'equip als quals pertany el gràfic.| |selectTemplateGroups|query|Retorna la propietat [grups de plantilles](/manual/api/reference/templategroup/object) amb els grups de plantilles 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|^| |selectGroups<br> (obsolet)|query|Aquest paràmetre és obsolets; si et plau, empra `selectHostGroups` o `selectTemplateGroups`.<br> Retorna una propietat `groups` amb el grup d'equips i grups de plantilles a qui pertany el gràfic.|

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 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.| |triggerids|string/array|Return only host groups that contain hosts 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|flag|Return only host groups that contain hosts.| |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 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\_hosts|flag|Return only host groups that contain monitored hosts.| |with\_monitored\_items|flag|Return only host groups that contain hosts 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`.| |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: `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|^| |monitored\_hosts<br>(deprecated)|flag|This parameter is deprecated, please use `with_monitored_hosts` instead.<br>Return only host groups that contain monitored hosts.| |real\_hosts<br>(deprecated)|flag|This parameter is deprecated, please use `with_hosts` instead.<br>Return only host groups that contain hosts.|
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.| |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\_hosts|flag|Retorna només grups d'equips que contenen equips monitorats.| |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`.| |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).| |excludeSearch|boolean|^| |filter|object|^| |limit|integer|^| |output|query|^| |preservekeys|boolean|^| |search|object|^| |searchByAny|boolean|^| |searchWildcardsEnabled|boolean|^| |sortorder|string/array|^| |startSearch|boolean|^| |monitored\_hosts(obsolet)|flag|Aquest paràmetre és obsolet; empreu `with_monitored_hosts` en el seu lloc.<br>Retorna només grups d'equips que contenen equips monitorats.| |real\_hosts<br>(obsolet)|flag|Aquest paràmetre és obsolet; empreu `with_hosts` en el seu lloc.<br>Retorna només grups d'equips que contenen equips.|

en-us	### Parameters  `(object)` Parameters defining the desired output.  The method supports the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |---------|---------------------------------------------------|-----------| |graphids|string/array|Return only template groups that contain templates with the given graphs.| |groupids|string/array|Return only template groups with the given template group IDs.| |templateids|string/array|Return only template groups that contain the given templates.| |triggerids|string/array|Return only template groups that contain templates with the given triggers.| |with\_graphs|flag|Return only template groups that contain templates with graphs.| |with\_graph\_prototypes|flag|Return only template groups that contain templates with graph prototypes.| |with\_httptests|flag|Return only template groups that contain templates with web checks.| |with\_items|flag|Return only template groups that contain templates with items.<br><br>Overrides the `with_simple_graph_items` parameters.| |with\_item\_prototypes|flag|Return only template groups that contain templates with item prototypes.<br><br>Overrides the `with_simple_graph_item_prototypes` parameter.| |with\_simple\_graph\_item\_prototypes|flag|Return only template groups that contain templates with item prototypes, which are enabled for creation and have numeric type of information.| |with\_simple\_graph\_items|flag|Return only template groups that contain templates with numeric items.| |with\_templates|flag|Return only template groups that contain templates.| |with\_triggers|flag|Return only template groups that contain templates with triggers.| |selectTemplates|query|Return a [templates](/manual/api/reference/template/object) property with the templates that belong to the template group.<br><br>Supports `count`.| |limitSelects|integer|Limits the number of records returned by subselects.<br><br>Applies to the following subselects:<br>`selectTemplates` - results will be sorted by `template`.| |sortfield|string/array|Sort the result by the given properties.<br><br>Possible values: `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  `(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ó| |---------|---------------------------------------- ------------|-----------| |graphids|string/array|Retorna només grups de plantilles que contenen plantilles amb els gràfics donats.| |groupids|string/array|Retorna només grups de plantilles amb els ID de grup de plantilles donats.| |templateids|string/array|Retorna només grups de plantilles que contenen les plantilles donades.| |triggerids|string/array|Retorna només grups de plantilles que contenen plantilles amb els triggers donats.| |with\_graphs|flag|Retorna només grups de plantilles que contenen plantilles amb gràfics.| |with\_graph\_prototypes|flag|Retorna només grups de plantilles que contenen plantilles amb prototips de gràfics.| |with\_httptests|flag|Retorna només grups de plantilles que contenen plantilles amb comprovacions web.| |with\_items|flag|Retorna només grups de plantilles que contenen plantilles amb elements.<br><br>Substitueix els paràmetres `with_simple_graph_items`.| |with\_item\_prototypes|flag|Retorna només grups de plantilles que contenen plantilles amb prototips d'elements.<br><br>Substitueix el paràmetre `with_simple_graph_item_prototypes`.| |with\_simple\_graph\_item\_prototypes|flag|Retorna només grups de plantilles que contenen plantilles amb prototips d'elements, que són habilitats per a la creació i tenen informació de tipus numèric.| |with\_simple\_graph\_items|flag|Retorna només grups de plantilles que contenen plantilles amb elements numèrics.| |with\_templates|flag|Retorna només grups de plantilles que contenen plantilles.| |with\_triggers|flag|Retorna només grups de plantilles que contenen plantilles amb triggers.| |selectTemplates|query|Retorna una propietat [templates](/manual/api/reference/template/object) amb les plantilles que pertanyen al grup de plantilles.<br><br>Admet `count`.| |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 `plantilla`.| |sortfield|string/array|Ordena el resultat per les propietats donades.<br><br>Valors possibles: `groupid`, `name`.| |countOutput|boolean|Aquests paràmetres que són comuns per a tots els mètodes `get` es descriuen en detall a la pàgina [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| |--|--|------| |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`.| |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.| |selectHostGroups|query|Return a [hostgroups](/manual/api/reference/hostgroup/object) property with host groups data that the host belongs to.| |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` property with [templates](/manual/api/reference/template/object) that the host is linked to.<br><br>In addition to Template object fields, it contains `link_type` - `(integer)` the way that the template is linked to host.<br>Possible values:<br>0 - *(default)* manually linked;<br>1 - automatically linked by LLD.<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: `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|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` instead.<br>Return a [groups](/manual/api/reference/hostgroup/object) property with host groups data that the host belongs to.|
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.| |template\_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\_graph|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`.| |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.| |selectHostGroups|query|Retorna una propietat [hostgrups](/manual/api/reference/hostgroup/object) amb els grups d'equip als quals pertany l'equip.| |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|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si et plau, empra `selectHostGroups` en el seu lloc.<br>Retorna la propietat [grups](/manual/api/reference/templategroup/object) amb informació dels grups d'equips on pertany l'equip.|

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.| |selectHostGroups|query|Return a [hostgroups](/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: `maintenanceid`, `name`, `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|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` instead.<br>Return a [groups](/manual/api/reference/hostgroup/object) property with host groups assigned to the maintenance.|
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.| |selectHostGroups|query|Retorna una propietat [hostgrups](/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|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si et plau, empra `selectHostGroups` en el seu lloc.<br>Retorna la propietat [grups](/manual/api/reference/templategroup/object) amb informació dels grups d'equips on pertany l'equip.|

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.| |selectHostGroups|query|Return a [hostgroups](/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: `scriptid`, `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|^| |selectGroups<br>(deprecated)|query|This parameter is deprecated, please use `selectHostGroups` instead.<br>Return a [groups](/manual/api/reference/hostgroup/object) property with host groups that the script can be run on.|
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.| |selectHostGroups|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|^| |selectGroups<br>(obsolet)|query|Aquest paràmetre és obsolet; si et plau, empra `selectHostGroups` en el seu lloc.<br>Retorna la propietat [grups](/manual/api/reference/templategroup/object) amb informació dels grups d'equips on pertany l'equip.|