[comment]: # translation:outdated
[comment]: # ({9464a98f-9464a98f})
# event.get
[comment]: # ({/9464a98f-9464a98f})
[comment]: # ({d5a208cb-a2311b6e})
### Description
`integer/array event.get(object parameters)`
La méthode permet de récupérer des événements en fonction des paramètres donnés.
::: noteimportant
Cette méthode peut renvoyer des événements d'une entité supprimée si ces événements n'ont pas encore été supprimés par le housekeeper.
:::
::: noteclassic
Cette méthode est disponible pour tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::
[comment]: # ({/d5a208cb-a2311b6e})
[comment]: # ({00212f55-99511e47})
### Paramètres
`(object)` Paramètres définissant la sortie souhaitée.
La méthode prend en charge les paramètres suivants.
|Paramètre|Type|Description|
|----------|----|-----------|
|eventids|string/array|Renvoie uniquement les événements avec les identifiants donnés.|
|groupids|string/array|Renvoie uniquement les événements créés par des objets appartenant aux groupes d'hôtes donnés.|
|hostids|string/array|Renvoie uniquement les événements créés par des objets appartenant aux hôtes donnés.|
|objectids|string/array|Renvoie uniquement les événements créés par les objets donnés.|
|source|integer|Renvoie uniquement les événements avec le type donné.
Se référer à la [page de l'objet Événement](/fr/manual/api/reference/event/object#evenement) pour une liste des types d'événements supportés.
Par défaut : 0 - événements de déclencheur.|
|object|integer|Renvoie uniquement les événements créés par des objets du type donné.
Se référer à la [page de l'objet Événement](/fr/manual/api/reference/event/object#evenement) pour une liste des types d'événements supportés.
Par défaut : 0 - déclencheur.|
|acknowledged|boolean|Si défini à `true`, ne renvoie que les événements acquittés.|
|suppressed|boolean|`true` - Renvoie uniquement les événements supprimés ;
`false` - Renvoie uniquement les événements supprimés dont l'état est normal.|
|severities|integer/array|Renvoie uniquement les événements avec des sévérités données. S'applique uniquement si l'objet est déclencheur.|
|evaltype|integer|Règles pour la recherche de tags.
Valeurs possibles :
0 - (par défaut) et/ou ;
2 - ou.|
|tags|array of object|Renvoie uniquement les événements avec des tags donnés. Correspondance exacte par tag et recherche non sensible à la casse par valeur et opérateur.
Format: `[{"tag": "", "value": "", "operator": ""}, ...]`.
Un tableau vide renvoie tous les événements.
Types d'opérateurs possibles :
0 - (par défaut) Like;
1 - Equal;
2 - Not like;
3 - Not equal
4 - Exists;
5 - Not exists.|
|eventid\_from|string|Renvoie uniquement les événements dont l'identifiant est supérieur ou égal à l'identifiant donné.|
|eventid\_till|string|Renvoie uniquement les événements dont l'identifiant est inférieur ou égal à l'identifiant donné.|
|time\_from|timestamp|Renvoie uniquement les événements créés après ou à l'heure indiquée.|
|time\_till|timestamp|Renvoie uniquement les événements créés avant ou à l'heure indiquée.|
|problem\_time\_from|timestamp|Renvoie uniquement les événements qui étaient en état problème depuis `problem_time_from`. S'applique uniquement si la source est un événement de déclencheur et que l'objet est un déclencheur. Obligatoire si `problem_time_till` est spécifié.|
|problem\_time\_till|timestamp|Renvoie uniquement les événements qui étaient en état problème jusqu'à`problem_time_till`. S'applique uniquement si la source est un événement de déclencheur et que l'objet est un déclencheur. Obligatoire si `problem_time_from` est spécifié.|
|value|integer/array|Renvoie uniquement les événements avec les valeurs données.|
|selectHosts|query|Renvoie une propriété [hosts](/manual/api/reference/host/object) avec les hôtes contenant l'objet qui a créé l'événement. Pris en charge uniquement pour les événements générés par des déclencheurs, des éléments ou des règles de découverte bas niveau.|
|selectRelatedObject|query|Renvoie une propriété `relatedObject avec l'objet qui a créé l'événement dans la propriété `. Le type d'objet renvoyé dépend du type d'événement.|
|select\_alerts|query|Renvoie une propriété [alerts](/manual/api/reference/alert/object) avec les alertes générées par l'événement. Les alertes sont triées dans l'ordre chronologique inverse.|
|select\_acknowledges|query|Renvoie une propriété `acknowledges` les mises à jour de l'événement. Les mises à jour d'événements sont triées dans l'ordre chronologique inverse.
L'objet de mise à jour d'événement a les propriétés suivantes :
`acknowledgeid` - `(string)` ID de l'acquittement ;
`userid` - `(string)` ID de l'utilisateur qui a mis à jour l'événement ;
`eventid` - `(string)` ID de l'événement mis à jour ;
`clock` - `(timestamp)` heure de mise à jour de l'événement ;
`message` - `(string)` texte du message ;
`action` - `(integer)` action de mise à jour effectuée, voir [event.acknowledge](/fr/manual/api/reference/event/acknowledge) ;
`old_severity` - `(integer)` sévérité de l'événement avant cette action de mise à jour ;
`new_severity` - `(integer)` sévérité de l'événement après cette action de mise à jour ;
`username` - `(string)` username de l'utilisateur qui a mis à jour l'événement ;
`name` - `(string)` nom de l'utilisateur qui a mis à jour l'événement ;
`surname` - `(string)` nom de famille de l'utilisateur qui a mis à jour l'événement.
Supporte `count`.|
|selectTags|query|Renvoie une propriété [tags](/manual/api/reference/event/object#Event_tag) avec les tags d'événement.|
|selectSuppressionData|query|Renvoie une propriété `suppression_data` avec la liste de maintenances :
`maintenanceid` - `(string)` ID de la maintenance ;
`suppress_until` - `(integer)` temps avant que l'événement soit supprimé.|
|sortfield|string/array|Trie le résultat par les propriétés données.
Les valeurs possibles sont : `eventid`, `objectid` et `clock`.|
|countOutput|boolean|Ces paramètres, communs à toutes les méthodes "get", sont décrits dans les [commentaires de référence](/fr/manual/api/reference_commentary#Parametres_communs_de_la_methode_get).|
|editable|boolean|^|
|excludeSearch|boolean|^|
|filter|object|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|search|object|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|
[comment]: # ({/00212f55-99511e47})
[comment]: # ({7223bab1-7223bab1})
### Valeurs retournées
`(integer/array)` Retourne soit :
- un tableau d'objets ;
- le nombre d'objets récupérés, si le paramètre `countOutput` a été utilisé.
[comment]: # ({/7223bab1-7223bab1})
[comment]: # ({b41637d2-b41637d2})
### Exemples
[comment]: # ({/b41637d2-b41637d2})
[comment]: # ({f5f8fbbd-7bd1e923})
#### Récupération d'événements de déclencheur
Récupérer les derniers événements du déclencheur "13926".
Requête :
``` {.java}
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"select_acknowledges": "extend",
"selectTags": "extend",
"selectSuppressionData": "extend",
"objectids": "13926",
"sortfield": ["clock", "eventid"],
"sortorder": "DESC"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Réponse :
``` {.java}
{
"jsonrpc": "2.0",
"result": [
{
"eventid": "9695",
"source": "0",
"object": "0",
"objectid": "13926",
"clock": "1347970410",
"value": "1",
"acknowledged": "1",
"ns": "413316245",
"name": "MySQL is down",
"severity": "5",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"opdata": "",
"acknowledges": [
{
"acknowledgeid": "1",
"userid": "1",
"eventid": "9695",
"clock": "1350640590",
"message": "Problem resolved.\n\r----[BULK ACKNOWLEDGE]----",
"action": "6",
"old_severity": "0",
"new_severity": "0",
"username": "Admin",
"name": "Zabbix",
"surname": "Administrator"
}
],
"suppression_data": [
{
"maintenanceid": "15",
"suppress_until": "1472511600"
}
],
"suppressed": "1",
"tags": [
{
"tag": "service",
"value": "mysqld"
},
{
"tag": "error",
"value": ""
}
]
},
{
"eventid": "9671",
"source": "0",
"object": "0",
"objectid": "13926",
"clock": "1347970347",
"value": "0",
"acknowledged": "0",
"ns": "0",
"name": "Unavailable by ICMP ping",
"severity": "4",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"opdata": "",
"acknowledges": [],
"suppression_data": [],
"suppressed": "0",
"tags": []
}
],
"id": 1
}
```
[comment]: # ({/f5f8fbbd-7bd1e923})
[comment]: # ({f06bb5da-adbe5436})
#### Récupération d'événements par période de temps
Récupérer tous les événements créés entre le 9 et le 10 octobre 2012, dans l'ordre chronologique inverse.
Requête :
``` {.java}
{
"jsonrpc": "2.0",
"method": "event.get",
"params": {
"output": "extend",
"time_from": "1349797228",
"time_till": "1350661228",
"sortfield": ["clock", "eventid"],
"sortorder": "desc"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Réponse :
``` {.java}
{
"jsonrpc": "2.0",
"result": [
{
"eventid": "20616",
"source": "0",
"object": "0",
"objectid": "14282",
"clock": "1350477814",
"value": "1",
"acknowledged": "0",
"ns": "0",
"name": "Less than 25% free in the history cache",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"opdata": "",
"suppressed": "0"
},
{
"eventid": "20617",
"source": "0",
"object": "0",
"objectid": "14283",
"clock": "1350477814",
"value": "0",
"acknowledged": "0",
"ns": "0",
"name": "Zabbix trapper processes more than 75% busy",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"opdata": "",
"suppressed": "0"
},
{
"eventid": "20618",
"source": "0",
"object": "0",
"objectid": "14284",
"clock": "1350477815",
"value": "1",
"acknowledged": "0",
"ns": "0",
"name": "High ICMP ping loss",
"severity": "3",
"r_eventid": "0",
"c_eventid": "0",
"correlationid": "0",
"userid": "0",
"opdata": "",
"suppressed": "0"
}
],
"id": 1
}
```
[comment]: # ({/f06bb5da-adbe5436})
[comment]: # ({c6eb3ba0-c6eb3ba0})
### Voir également
- [Alerte](/fr/manual/api/reference/alert/object)
- [Élément](/fr/manual/api/reference/item/object)
- [Hôte](/fr/manual/api/reference/host/object)
- [Règle de découverte bas niveau](/fr/manual/api/reference/discoveryrule/object#regle_de_decouverte_bas_niveau)
- [Déclencheur](/fr/manual/api/reference/trigger/object)
[comment]: # ({/c6eb3ba0-c6eb3ba0})
[comment]: # ({f85dc7ca-f85dc7ca})
### Source
CEvent::get() dans *ui/include/classes/api/services/CEvent.php*.
[comment]: # ({/f85dc7ca-f85dc7ca})