[comment]: # ({fc5b81d2-fc5b81d2})
# trigger.get

[comment]: # ({/fc5b81d2-fc5b81d2})

[comment]: # ({f493658b-e77e3d1e})
### Descripció

`integer/array trigger.get(object parameters)`

El mètode permet recuperar triggers segons els paràmetres proveïts.

::: noteclassic
Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/f493658b-e77e3d1e})

[comment]: # ({7fff372f-44938a82})
### Paràmetres

`(object)` Paràmetres definint la sortida esperada.

El mètode admet els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data-types)|Descripció|
|--|--|------|
|triggerids|ID/array|Retorna només triggers amb els identificadors donats.|
|groupids|ID/array|Retorna només triggers que pertanyen als equips dels grups d'equips donats.|
|templateids|ID/array|Retorna només triggers que pertanyen a les plantilles donades.|
|hostids|ID/array|Retorna només triggers que pertanyen als equips donats.|
|itemids|ID/array|Retorna només triggers que contenen els elements donats.|
|functions|string/array|Retorna només triggers que empren les funcions donades.<br><br>Consulteu la pàgina [funcions de triggers admeses](/manual/appendix/triggers/functions) per obtindre una llista de funcions admeses.|
|group|string|Retorna només triggers que pertanyen als equips o plantilles del grup d'equips o grup de plantilles amb el nom donat.|
|host|string|Retorna només triggers pertanyents a l'equip amb el nom tècnic donat.|
|inherited|boolean|Si es defineix com a `true`, només retorna triggers heretats d'una plantilla.|
|template|boolean|Si s'estableix a `true`, només retorna triggers que pertanyen a plantilles.|
|dependent|boolean|Si s'estableix a `true`, només retorna triggers que tenen dependències. Si s'estableix a `fals', només retorna triggers que no tenen dependències.|
|monitored|flag|Retorna només triggers activats que pertanyen als equips monitorats i que només contenen elements activats.|
|active|flag|Retorna només triggers activats que pertanyen als equips monitorats.|
|maintenance|boolean|Si s'estableix a `true`, només retorna triggers activats que pertanyen als equips en manteniment.|
|withUnacknowledgedEvents|flag|Retorna només triggers que tenen esdeveniments no reconeguts.|
|withAcknowledgedEvents|flag|Retorna només triggers amb tots els esdeveniments reconeguts.|
|withLastEventUnacknowledged|flag|Retorna només triggers amb el darrer esdeveniment no reconegut.|
|skipDependent|flag|Omet els triggers en un estat problemàtic que depenen d'altres triggers. Tingueu en compte que altres triggers s'ignoren si són desactivats, tenen elements desactivats o tenen equips d'elements desactivats.|
|lastChangeSince|timestamp|Retorna només els triggers que han canviat d'estat després del temps d'espera.|
|lastChangeTill|timestamp|Retorna només els triggers que han canviat d'estat abans de l'hora especificada.|
|només\_true|flag|Retorna només els triggers que han tingut un problema recentment.|
|min\_severity|enteger|Retorna només triggers amb una gravetat superior o igual a la gravetat donada.|
|evaltype|integer|Etiqueta [mètode d'avaluació](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter).<br><br>Valors possibles:<br>0 - (per defecte) I/O;<br>2 - O.|
|tags|matriu|Retorna només els esdeveniments amb les etiquetes donades. Coincidència exacta per etiqueta i cerca que distingeix entre majúscules i minúscules o no per valor d'etiqueta segons el valor de l'operador.<br>Format: `[{"etiqueta": "<etiqueta>", "valor": "<valor>", "operador": "<operador>"}, ...]`.<br>Una matriu buida retorna tots els esdeveniments.<br><br>Tipus d'[operador](/manual/web_interface/frontend_sections/data_collection/hosts#using-filter) possibles:<br>0 - *(per defecte)* Conté (coincidència de subcadena, distingeix entre majúscules i minúscules);<br>1 - Igual a (distingeix entre majúscules i minúscules);<br>2 - No conté (coincidència de subcadena, distingeix entre majúscules i minúscules);<br>3 - No és igual a (distingeix entre majúscules i minúscules);<br>4 - Existeix;<br>5 - No existeix.|
|expandComment|flag|Amplieu les macros a la descripció del trigger.|
|expandDescription|flag|Amplieu les macros al nom del trigger.|
|expandExpression|flag|Amplieu macros i funcions a l'expressió del trigger.|
|selectHostGroups|query|Retorna els grups d'equips als quals pertany el trigger a la propietat [hostgrups](/manual/api/reference/hostgroup/object).|
|selectHosts|query|Retorna els equips als quals pertany el trigger a la propietat [equips](/manual/api/reference/host/object).|
|selectItems|query|Retorna els elements continguts al trigger a la propietat [elements](/manual/api/reference/item/object).|
|selectFunctions|query|Retorna les funcions utilitzades per el trigger a la propietat `functions`.<br><br>Els objectes de funció representen les funcions utilitzades a l'expressió del trigger i tenen les propietats següents:<br>`functionid` - *(cadena)* ID de la funció;<br>`itemid` - *(cadena)* ID de l'element utilitzat a la funció;<br>`triggerid` - *(cadena)* ID del trigger que utilitza la funció;<br>`function` - *(cadena)* nom de la funció;<br>`parameter` - *(cadena)* paràmetre passat a la funció. El paràmetre de consulta es substitueix pel símbol `$` a la cadena retornada.|
|selectDependencies|query|Retorna els triggers dels quals depèn el trigger a la propietat `dependencies`.|
|selectDiscoveryRule|query|Retorna la [regla de descoberta de baix nivell](/manual/api/reference/discoveryrule/object#discovery-rule) que ha creat el trigger.|
|selectLastEvent|query|Retorna el darrer esdeveniment de trigger significatiu a la propietat [lastEvent](/manual/api/reference/event/objecte).|
|selectTags|query|Retorna les etiquetes de trigger a la propietat [etiquetes](/manual/api/reference/trigger/object#trigger-tag).|
|selectTemplateGroups|query|Retorna els grups de plantilles als quals pertany el trigger a la propietat [templategrups](/manual/api/reference/templategroup/object).|
|selectTriggerDiscovery|query|Retorna l'objecte de descoberta del trigger a la propietat `triggerDiscovery`. Els objectes de descoberta del trigger emllaçen el trigger a un prototip de trigger a partir del qual s'ha creat.<br><br>Té les propietats següents:<br>`parent_triggerid` - `(cadena)` ID del prototip de trigger des del qual s'ha creat el trigger;<br>`status` - `(int)` estat de descoberta del trigger:<br>0 - *(per defecte)* s'ha descobert el trigger,<br>1 - el trigger ja no es troba;<br>`ts_delete` - `(timestamp)` hora en què s'esborrarà un trigger que ja no es trobi;<br>`ts_disable` - `(timestamp)` hora en què es desactivarà un trigger que ja no es trobi;<br>`disable_source` - `(int)` indicador de si el trigger s'ha desactivat mitjançant una regla LLD o manualment:<br>0 - *(per defecte)* desactivat automàticament,<br>1 - desactivat per una regla LLD.|
|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>No admet propietats de [tipus](/manual/api/reference_commentary#data-types) `text`.<br><br>Admet filtres addicionals:<br>`equip` - nom tècnic de l'equip al qual pertany el trigger;<br>`hostid` - ID de l'equip al qual pertany el trigger.|
|limitSelects|integer|Limita el nombre de registres retornats per les subconsultes.<br><br>S'aplica a les subseleccions següents:<br>`selectHosts`: els resultats s'ordenaran per `equip`.|
|sortfield|string/array|[Ordena](/fr/manual/api/reference_commentary#Common_parameters_of_the_get_method) el resultat per les propietats donades.<br><br>Valors possibles: `triggerid`, `description`, `status`, `priority`, `lastchange` i `hostname`.|
|countOutput|boolean|Aquests paràmetres 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`.|

[comment]: # ({/7fff372f-44938a82})

[comment]: # ({07ca11ca-7223bab1})
### Valors de retorn

`(integer/array)` Retorna un d'entre:

-   una taula d'objectes;
-   el recompte d'objectes recuperats, si s'empra el paràmetre `countOutput`.

[comment]: # ({/07ca11ca-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({d9d4c665-3d27e76d})
#### Recuperar informació per ID de trigger

Recupera tota la informació i les funcions que empra el trigger "14062".

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "trigger.get",
    "params": {
        "triggerids": "14062",
        "output": "extend",
        "selectFunctions": "extend"
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "14062",
            "expression": "{13513}<10m",
            "description": "L'equip {HOST.NAME} s'ha hagut de reiniciar (temps d'activitat < 10m)",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "El temps d'activitat de l'equip és inferior a 10 minuts",
            "error": "",
            "templateid": "10016",
            "type": "0",
            "state": "0",
            "flags": "0",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "functions": [
                {
                    "functionid": "13513",
                    "itemid": "24350",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        }
    ],
    "id": 1
}
```

[comment]: # ({/d9d4c665-3d27e76d})

[comment]: # ({a6701c25-8a31301f})
#### Recuperar els triggers amb estat problemàtic

Recupera l'ID, nom i gravetat de tots els triggers en estat problemàtic, i ordenar-los per gravetat en ordre decreixent.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "trigger.get",
    "params": {
        "output": [
            "triggerid",
            "description",
            "priority"
        ],
        "filter": {
            "value": 1
        },
        "sortfield": "priority",
        "sortorder": "DESC"
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "13907",
            "description": "Zabbix self-monitoring processes < 100% busy",
            "priority": "4"
        },
        {
            "triggerid": "13824",
            "description": "Zabbix discoverer processes more than 75% busy",
            "priority": "3"
        }
    ],
    "id": 1
}
```

[comment]: # ({/a6701c25-8a31301f})

[comment]: # ({d9fc89e0-8005126d})
#### Recuperar un trigger específic amb etiquetes

Recuperar un trigger específic amb etiquetes.

[Petició](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "trigger.get",
    "params": {
        "output": [
            "triggerid",
            "description"
        ],
        "selectTags": "extend",
        "triggerids": [
            "17578"
        ]
    },
    "id": 1
}
```

Resposta:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "17370",
            "description": "Service status",
            "tags": [
                {
                    "tag": "service",
                    "value": "{{ITEM.VALUE}.regsub(\"Service (.*) has stopped\", \"\\1\")}"
                },
                {
                    "tag": "error",
                    "value": ""
                }
            ]
        }
    ],
    "id": 1
}
```

[comment]: # ({/d9fc89e0-8005126d})

[comment]: # ({cf0cf439-222d46a0})
### Veieu també

-   [Regla de descoberta](/manual/api/reference/discoveryrule/object#discovery-rule)
-   [Element](/manual/api/reference/item/object#item)
-   [Equip](/manual/api/reference/host/object#host)
-   [Grup d'equips](/manual/api/reference/hostgroup/object#host-group)
-   [Grup de plantilles](/manual/api/reference/templategroup/object#template-group)

[comment]: # ({/cf0cf439-222d46a0})

[comment]: # ({07515392-07515392})
### Font

CTrigger::get() in *ui/include/classes/api/services/CTrigger.php*.

[comment]: # ({/07515392-07515392})