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

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

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

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

Die Methode ermöglicht das Abrufen von Auslösern anhand der angegebenen Parameter.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar. Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen werden.
Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object)` Parameter, die die gewünschte Ausgabe definieren.

Die Methode unterstützt die folgenden Parameter.

|Parameter|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|triggerids|ID/array|Nur Auslöser mit den angegebenen IDs zurückgeben.|
|groupids|ID/array|Nur Auslöser zurückgeben, die zu Hosts oder Vorlagen aus den angegebenen Hostgruppen oder Vorlagengruppen gehören.|
|templateids|ID/array|Nur Auslöser zurückgeben, die zu den angegebenen Vorlagen gehören.|
|hostids|ID/array|Nur Auslöser zurückgeben, die zu den angegebenen Hosts gehören.|
|itemids|ID/array|Nur Auslöser zurückgeben, die die angegebenen Datenpunkte enthalten.|
|functions|string/array|Nur Auslöser zurückgeben, die die angegebenen Funktionen verwenden.<br><br>Eine Liste der unterstützten Funktionen finden Sie auf der Seite [unterstützte Funktionen](/manual/appendix/functions).|
|group|string|Nur Auslöser zurückgeben, die zu Hosts oder Vorlagen aus der Hostgruppe oder Vorlagengruppe mit dem angegebenen Namen gehören.|
|host|string|Nur Auslöser zurückgeben, die zu dem Host mit dem angegebenen technischen Namen gehören.|
|inherited|boolean|Wenn auf `true` gesetzt, nur Auslöser zurückgeben, die von einer Vorlage geerbt wurden.|
|templated|boolean|Wenn auf `true` gesetzt, nur Auslöser zurückgeben, die zu Vorlagen gehören.|
|dependent|boolean|Wenn auf `true` gesetzt, nur Auslöser zurückgeben, die Abhängigkeiten haben. Wenn auf `false` gesetzt, nur Auslöser zurückgeben, die keine Abhängigkeiten haben.|
|monitored|flag|Nur aktivierte Auslöser zurückgeben, die zu überwachten Hosts gehören und nur aktivierte Datenpunkte enthalten.|
|active|flag|Nur aktivierte Auslöser zurückgeben, die zu überwachten Hosts gehören.|
|maintenance|boolean|Wenn auf `true` gesetzt, nur aktivierte Auslöser zurückgeben, die zu Hosts in Wartung gehören.|
|withUnacknowledgedEvents|flag|Nur Auslöser zurückgeben, die nicht bestätigte Ereignisse haben.|
|withAcknowledgedEvents|flag|Nur Auslöser mit allen bestätigten Ereignissen zurückgeben.|
|withLastEventUnacknowledged|flag|Nur Auslöser zurückgeben, bei denen das letzte Ereignis nicht bestätigt ist.|
|skipDependent|flag|Auslöser im Problemzustand überspringen, die von anderen Auslösern abhängig sind. Beachten Sie, dass die anderen Auslöser ignoriert werden, wenn sie deaktiviert sind, deaktivierte Datenpunkte haben oder die Hosts der Datenpunkte deaktiviert sind.|
|lastChangeSince|timestamp|Nur Auslöser zurückgeben, deren Zustand sich nach der angegebenen Zeit geändert hat.|
|lastChangeTill|timestamp|Nur Auslöser zurückgeben, deren Zustand sich vor der angegebenen Zeit geändert hat.|
|only\_true|flag|Nur Auslöser zurückgeben, die sich kürzlich in einem Problemzustand befunden haben.|
|min\_severity|integer|Nur Auslöser mit einer Schwere größer oder gleich der angegebenen Schwere zurückgeben.|
|evaltype|integer|Tag-[Auswertungsmethode](/manual/web_interface/frontend_sections/data_collection/hosts/triggers#using-filter) festlegen.<br><br>Mögliche Werte:<br>0 - *(Standard)* Und/Oder;<br>2 - Oder.|
|tags|array|Nur Auslöser mit den angegebenen Tags zurückgeben.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Ein leeres Array gibt alle Auslöser zurück.<br><br>Mögliche [Operator](/manual/web_interface/frontend_sections/data_collection/hosts/triggers#using-filter)-Werte:<br>0 - *(Standard)* Enthält;<br>1 - Ist gleich;<br>2 - Enthält nicht;<br>3 - Ist nicht gleich;<br>4 - Existiert;<br>5 - Existiert nicht.|
|expandComment|flag|Makros in der Auslöserbeschreibung erweitern.|
|expandDescription|flag|Makros im Namen des Auslösers erweitern.|
|expandExpression|flag|Funktionen und Makros im Auslöserausdruck erweitern.|
|selectHostGroups|query|Die Hostgruppen zurückgeben, zu denen der Auslöser gehört, in der Eigenschaft [`hostgroups`](/manual/api/reference/hostgroup/object).|
|selectHosts|query|Die Hosts zurückgeben, zu denen der Auslöser gehört, in der Eigenschaft [`hosts`](/manual/api/reference/host/object).|
|selectItems|query|Die vom Auslöser enthaltenen Datenpunkte in der Eigenschaft [`items`](/manual/api/reference/item/object) zurückgeben.|
|selectFunctions|query|Die im Auslöser verwendeten Funktionen in der Eigenschaft `functions` zurückgeben.<br><br>Die Funktionsobjekte stellen die im Auslöserausdruck verwendeten Funktionen dar und haben die folgenden Eigenschaften:<br>`functionid` - `(ID)` ID der Funktion;<br>`itemid` - `(ID)` ID des in der Funktion verwendeten Datenpunkts;<br>`function` - `(string)` Name der Funktion;<br>`parameter` - `(string)` an die Funktion übergebener Parameter. Der Query-Parameter wird im zurückgegebenen String durch das Symbol `$` ersetzt.|
|selectDependencies|query|Die Auslöser zurückgeben, von denen der Auslöser abhängt, in der Eigenschaft `dependencies`.|
|selectDiscoveryRule|query|Die [Low-Level-Discovery-Regel](/manual/api/reference/discoveryrule/object#lld-rule) zurückgeben, die den Auslöser in der Eigenschaft `discoveryRule` erstellt hat.|
|selectLastEvent|query|Das letzte signifikante Auslöserereignis in der Eigenschaft [`lastEvent`](/manual/api/reference/event/object) zurückgeben.|
|selectTags|query|Die Auslöser-Tags in der Eigenschaft [`tags`](/manual/api/reference/trigger/object#trigger-tag) zurückgeben.|
|selectTemplateGroups|query|Die Vorlagengruppen zurückgeben, zu denen der Auslöser gehört, in der Eigenschaft [`templategroups`](/manual/api/reference/templategroup/object).|
|selectTriggerDiscovery|query|Das Objekt zur Auslösererkennung in der Eigenschaft `triggerDiscovery` zurückgeben. Die Objekte zur Auslösererkennung verknüpfen den Auslöser mit einem Auslöserprototyp, aus dem er erstellt wurde.<br><br>Es hat die folgenden Eigenschaften:<br>`parent_triggerid` - `(ID)` ID des Auslöserprototyps, aus dem der Auslöser erstellt wurde;<br>`status` - `(int)` Status der Auslösererkennung:<br>0 - *(Standard)* Auslöser ist erkannt,<br>1 - Auslöser wird nicht mehr erkannt;<br>`ts_delete` - `(timestamp)` Zeitpunkt, zu dem ein nicht mehr erkannter Auslöser gelöscht wird;<br>`ts_disable` - `(timestamp)` Zeitpunkt, zu dem ein nicht mehr erkannter Auslöser deaktiviert wird;<br>`disable_source` - `(int)` Kennzeichnung, ob der Auslöser durch eine LLD-Regel oder manuell deaktiviert wurde:<br>0 - *(Standard)* automatisch deaktiviert,<br>1 - durch eine LLD-Regel deaktiviert.|
|filter|object|Nur Ergebnisse zurückgeben, die genau dem angegebenen Filter entsprechen.<br><br>Akzeptiert ein Objekt, bei dem die Schlüssel Eigenschaftsnamen sind und die Werte entweder ein einzelner Wert oder ein Array von Werten sind, mit denen verglichen werden soll.<br><br>Unterstützt keine Eigenschaften vom [Datentyp](/manual/api/reference_commentary#data-types) `text`.<br><br>Unterstützt zusätzliche Eigenschaften:<br>`host` - technischer Name des Hosts, zu dem der Auslöser gehört;<br>`hostid` - ID des Hosts, zu dem der Auslöser gehört.|
|limitSelects|integer|Begrenzt die Anzahl der von Unterabfragen zurückgegebenen Datensätze.<br><br>Gilt für die folgenden Unterabfragen:<br>`selectHosts` - Ergebnisse werden nach `host` sortiert.|
|sortfield|string/array|Das Ergebnis nach den angegebenen Eigenschaften [sortieren](/manual/api/reference_commentary#common-get-method-parameters).<br><br>Mögliche Werte: `triggerid`, `description`, `status`, `priority`, `lastchange`, `hostname`.|
|countOutput|boolean|Diese Parameter werden in der [Referenzdokumentation](/manual/api/reference_commentary#common-get-method-parameters) beschrieben.|
|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|Dieser Parameter ist veraltet, bitte verwenden Sie stattdessen `selectHostGroups` oder `selectTemplateGroups`.<br>Die Hostgruppen und Vorlagengruppen zurückgeben, zu denen der Auslöser gehört, in der Eigenschaft `groups`.|

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

[comment]: # ({07ca11ca-7223bab1})
### Rückgabewerte

`(integer/array)` Gibt entweder Folgendes zurück:

-   ein Array von Objekten;
-   die Anzahl der abgerufenen Objekte, wenn der Parameter `countOutput` verwendet wurde.

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

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

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

[comment]: # ({d9d4c665-3d27e76d})
#### Abrufen von Daten anhand der Auslöser-ID

Rufen Sie alle Daten und die in Auslöser "14062" verwendeten Funktionen ab.

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

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

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "14062",
            "expression": "{13513}<10m",
            "description": "{HOST.NAME} has been restarted (uptime < 10m)",
            "url": "",
            "status": "0",
            "value": "0",
            "priority": "2",
            "lastchange": "0",
            "comments": "The host uptime is less than 10 minutes",
            "error": "",
            "templateid": "10016",
            "type": "0",
            "state": "0",
            "flags": "0",
            "recovery_mode": "0",
            "recovery_expression": "",
            "correlation_mode": "0",
            "correlation_tag": "",
            "manual_close": "0",
            "opdata": "",
            "event_name": "",
            "uuid": "",
            "url_name": "",
            "functions": [
                {
                    "functionid": "13513",
                    "itemid": "24350",
                    "parameter": "$",
                    "function": "last"
                }
            ]
        }
    ],
    "id": 1
}
```

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

[comment]: # ({a6701c25-8a31301f})
#### Auslöser im Problemzustand abrufen

Rufen Sie die ID, den Namen und den Schweregrad aller Auslöser im Problemzustand ab und sortieren Sie sie nach Schweregrad in absteigender Reihenfolge.

[Anfrage](/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
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "triggerid": "13907",
            "description": "Zabbix-Selbstüberwachungsprozesse < 100 % ausgelastet",
            "priority": "4"
        },
        {
            "triggerid": "13824",
            "description": "Zabbix-Discoverer-Prozesse mehr als 75 % ausgelastet",
            "priority": "3"
        }
    ],
    "id": 1
}
```

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

[comment]: # ({d9fc89e0-8005126d})
#### Abrufen eines bestimmten Auslösers mit Tags

Rufen Sie einen bestimmten Auslöser mit Tags ab.

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

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

Antwort:

```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})
### Siehe auch

-   [Discovery-Regel](/manual/api/reference/discoveryrule/object#discovery-rule)
-   [Datenpunkt](/manual/api/reference/item/object#item)
-   [Host](/manual/api/reference/host/object#host)
-   [Host-Gruppe](/manual/api/reference/hostgroup/object#host-group)
-   [Vorlagengruppe](/manual/api/reference/templategroup/object#template-group)

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

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

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

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