[comment]: # translation:outdated

[comment]: # ({48cd3524-48cd3524})
# problem.get

[comment]: # ({/48cd3524-48cd3524})

[comment]: # ({c91e55ea-a18b2713})
### Beschreibung

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

Mit dieser Methode können Probleme entsprechend den angegebenen
Parametern abgerufen werden.

Diese Methode dient zum Abrufen ungelöster Probleme. Optional können,
falls angegeben, zusätzlich kürzlich gelöste Probleme abgerufen werden. Der
Zeitraum, der bestimmt, wie alt „kürzlich“ ist, wird unter
*Administration* →
*[General](/manual/web_interface/frontend_sections/administration/general#trigger-displaying-options)* definiert.
Probleme, die vor diesem Zeitraum gelöst wurden, werden nicht in der
Problemtabelle gespeichert. Um Probleme abzurufen, die weiter in der
Vergangenheit gelöst wurden, verwenden Sie die Methode
[`event.get`](/manual/api/reference/event/get).

::: noteimportant
Diese Methode kann Probleme einer gelöschten
Entität zurückgeben, wenn diese Probleme noch nicht vom Housekeeper
entfernt wurden.
:::

::: noteclassic
Diese Methode steht Benutzern aller Typen zur Verfügung. Die Berechtigungen
zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle
entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/c91e55ea-a18b2713})

[comment]: # ({ec05f91b-98f39c6a})
### Parameter

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

Die Methode unterstützt die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|eventids|ID/array|Gibt nur Probleme mit den angegebenen IDs zurück.|
|groupids|ID/array|Gibt nur Probleme zurück, die von Objekten erstellt wurden, die zu den angegebenen Host-Gruppen gehören.|
|hostids|ID/array|Gibt nur Probleme zurück, die von Objekten erstellt wurden, die zu den angegebenen Hosts gehören.|
|objectids|ID/array|Gibt nur Probleme zurück, die von den angegebenen Objekten erstellt wurden.|
|source|integer|Gibt nur Probleme mit dem angegebenen Typ zurück.<br><br>Eine Liste der unterstützten Ereignistypen finden Sie auf der Seite [Problemereignisobjekt](object#problem).<br><br>Standard: 0 - Problem, das durch einen Auslöser erstellt wurde.|
|object|integer|Gibt nur Probleme zurück, die von Objekten des angegebenen Typs erstellt wurden.<br><br>Eine Liste der unterstützten Objekttypen finden Sie auf der Seite [Problemereignisobjekt](object#problem).<br><br>Standard: 0 - Auslöser.|
|acknowledged|boolean|Wenn auf `true` gesetzt, werden nur bestätigte Probleme zurückgegeben.|
|action|integer|Gibt nur Probleme zurück, für die die angegebenen [Ereignisaktualisierungsaktionen](/manual/api/reference/event/acknowledge#parameters) durchgeführt wurden. Verwenden Sie bei mehreren Aktionen die Summe beliebiger zulässiger Bitmap-Werte als Bitmaske (zum Beispiel 34 für Bestätigen und Unterdrücken des Ereignisses).|
|action_userids|ID/array|Gibt nur Probleme mit den angegebenen IDs von Benutzern zurück, die die Aktualisierungsaktionen des Problemereignisses durchgeführt haben.|
|suppressed|boolean|Wenn auf `true` gesetzt, werden nur unterdrückte Probleme zurückgegeben.|
|symptom|boolean|Wenn auf `true` gesetzt, werden nur Symptom-Problemereignisse zurückgegeben.|
|severities|integer/array|Gibt nur Probleme mit den angegebenen Ereignisschweregraden zurück. Gilt nur, wenn object ein Auslöser ist.|
|evaltype|integer|Tag-[Auswertungsmethode](/manual/web_interface/frontend_sections/monitoring/problems#using-filter).<br><br>Mögliche Werte:<br>0 - *(Standard)* Und/Oder;<br>2 - Oder.|
|tags|array|Gibt nur Probleme mit den angegebenen Tags zurück.<br>Format: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...]`.<br>Ein leeres Array gibt alle Probleme zurück.<br><br>Mögliche Werte für [operator](/manual/web_interface/frontend_sections/monitoring/problems#using-filter):<br>0 - *(Standard)* Enthält;<br>1 - Entspricht;<br>2 - Enthält nicht;<br>3 - Entspricht nicht;<br>4 - Existiert;<br>5 - Existiert nicht.|
|recent|boolean|Wenn auf `true` gesetzt, werden aktuelle Probleme zurückgegeben, einschließlich derjenigen, die innerhalb von [`ok_period`](/manual/api/reference/settings/object) behoben wurden, sowie aller ungelösten Probleme.<br>Wenn auf `false` gesetzt, werden nur ungelöste Probleme zurückgegeben.|
|eventid\_from|string|Gibt nur Probleme mit IDs zurück, die größer oder gleich der angegebenen ID sind.|
|eventid\_till|string|Gibt nur Probleme mit IDs zurück, die kleiner oder gleich der angegebenen ID sind.|
|time\_from|timestamp|Gibt nur Probleme zurück, die nach oder zum angegebenen Zeitpunkt erstellt wurden.|
|time\_till|timestamp|Gibt nur Probleme zurück, die vor oder zum angegebenen Zeitpunkt erstellt wurden.|
|selectAcknowledges|query|Gibt eine `acknowledges`-Eigenschaft mit den Problemaktualisierungen zurück. Problemaktualisierungen werden in umgekehrter chronologischer Reihenfolge sortiert.<br><br>Das Problemaktualisierungsobjekt hat die folgenden Eigenschaften:<br>`acknowledgeid` - `(ID)` ID der Aktualisierung;<br>`userid` - `(ID)` ID des Benutzers, der das Ereignis aktualisiert hat;<br>`eventid` - `(ID)` ID des aktualisierten Ereignisses;<br>`clock` - `(timestamp)` Zeitpunkt, zu dem das Ereignis aktualisiert wurde;<br>`message` - `(string)` Text der Nachricht;<br>`action` - `(integer)`Typ der Aktualisierungsaktion (siehe [`event.acknowledge`](/manual/api/reference/event/acknowledge));<br>`old_severity` - `(integer)` Ereignisschweregrad vor dieser Aktualisierungsaktion;<br>`new_severity` - `(integer)` Ereignisschweregrad nach dieser Aktualisierungsaktion;<br>`suppress_until` - `(timestamp)` Zeitpunkt, bis zu dem das Ereignis unterdrückt wird;<br>`taskid` - `(ID)` ID der Aufgabe, falls für das aktuelle Ereignis gerade eine Rangänderung durchgeführt wird.<br><br>Unterstützt `count`.|
|selectTags|query|Gibt eine [`tags`](/manual/api/reference/problem/object#problem-tag)-Eigenschaft mit den Problem-Tags zurück. Ausgabeformat: `[{"tag": "<tag>", "value": "<value>"}, ...]`.|
|selectSuppressionData|query|Gibt eine `suppression_data`-Eigenschaft mit der Liste aktiver Wartungen und manueller Unterdrückungen zurück:<br>`maintenanceid` - `(ID)` ID der Wartung;<br>`userid` - `(ID)` ID des Benutzers, der das Problem unterdrückt hat;<br>`suppress_until` - `(integer)` Zeitpunkt, bis zu dem das Problem unterdrückt wird.|
|filter|object|Gibt nur die Ergebnisse zurück, die exakt 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 abgeglichen werden soll.<br><br>Unterstützt keine Eigenschaften des `text`-[Datentyps](/manual/api/reference_commentary#data-types).|
|sortfield|string/array|Sortiert das Ergebnis nach den angegebenen Eigenschaften.<br><br>Mögliche Werte: `eventid`.|
|countOutput|boolean|Diese Parameter sind in der [Referenzkommentierung](/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|^|

[comment]: # ({/ec05f91b-98f39c6a})

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

`(integer/array)` Kann die folgenden Dinge zurück geben:

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

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

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

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

[comment]: # ({9d82627b-4d83529d})
#### Abrufen von Problemereignissen eines Auslösers

Rufen Sie aktuelle Ereignisse des Auslösers „15112“ ab.

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

```json
{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
        "output": "extend",
        "selectAcknowledges": "extend",
        "selectTags": "extend",
        "selectSuppressionData": "extend",
        "objectids": "15112",
        "recent": true,
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "1245463",
            "source": "0",
            "object": "0",
            "objectid": "15112",
            "clock": "1472457242",
            "ns": "209442442",
            "r_eventid": "1245468",
            "r_clock": "1472457285",
            "r_ns": "125644870",
            "correlationid": "0",
            "userid": "1",
            "name": "Zabbix-Agent auf localhost ist seit 5 Minuten nicht erreichbar",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "acknowledgeid": "14443",
                    "userid": "1",
                    "eventid": "1245463",
                    "clock": "1472457281",
                    "message": "Problem behoben",
                    "action": "6",
                    "old_severity": "0",
                    "new_severity": "0",
                    "suppress_until": "1472511600",
                    "taskid": "0"
                }
            ],
            "suppression_data": [
                {
                    "maintenanceid": "15",
                    "suppress_until": "1472511600",
                    "userid": "0"
                }
            ],
            "suppressed": "1",
            "tags": [
                {
                    "tag": "test-tag",
                    "value": "test-value"
                }
            ]
        }
    ],
    "id": 1
}
```

[comment]: # ({/9d82627b-4d83529d})

[comment]: # ({36151502-by})
#### Abrufen von Problemen, die von einem angegebenen Benutzer bestätigt wurden

Abrufen von Problemen, die von einem Benutzer mit ID=10 bestätigt wurden

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

```json
{
    "jsonrpc": "2.0",
    "method": "problem.get",
    "params": {
        "output": "extend",
        "action": 2,
        "action_userids": [10],
        "selectAcknowledges": ["userid", "action"],
        "sortfield": ["eventid"],
        "sortorder": "DESC"
    },
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": [
        {
            "eventid": "1248566",
            "source": "0",
            "object": "0",
            "objectid": "15142",
            "clock": "1472457242",
            "ns": "209442442",
            "r_eventid": "1245468",
            "r_clock": "1472457285",
            "r_ns": "125644870",
            "correlationid": "0",
            "userid": "10",
            "name": "Zabbix Agent auf localhost ist seit 5 Minuten nicht erreichbar",
            "acknowledged": "1",
            "severity": "3",
            "cause_eventid": "0",
            "opdata": "",
            "acknowledges": [
                {
                    "userid": "10",
                    "action": "2"
                }
            ],
            "suppressed": "0"
        }
    ],
    "id": 1
}
```

[comment]: # ({/36151502-by})

[comment]: # ({f5742bff-c6eb3ba0})
### Siehe auch

-   [Alarm](/manual/api/reference/alert/object)
-   [Datenpunkt](/manual/api/reference/item/object)
-   [Host](/manual/api/reference/host/object)
-   [LLD-Regel](/manual/api/reference/discoveryrule/object#lld-rule)
-   [Auslöser](/manual/api/reference/trigger/object)

[comment]: # ({/f5742bff-c6eb3ba0})

[comment]: # ({15f9267d-15f9267d})
### Quelle

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

[comment]: # ({/15f9267d-15f9267d})