[comment]: # ({9464a98f-9464a98f})
# אירוע.קבל

[comment]: # ({/9464a98f-9464a98f})

[comment]: # ({1c582721-a2311b6e})
### תיאור

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

השיטה מאפשרת לאחזר אירועים לפי הפרמטרים הנתונים.

::: הערה חשוב
שיטה זו עשויה להחזיר אירועים של ישות שנמחקה
אם אירועים אלה לא הוסרו על ידי עוזרת הבית
עדיין.
:::

::: noteclassic
שיטה זו זמינה למשתמשים מכל סוג. הרשאות
כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/1c582721-a2311b6e})

[comment]: # ({09930242-99511e47})
### פרמטרים

`(object)` פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|eventids|string/array|החזר רק אירועים עם המזהים הנתונים.|
|groupids|string/array|החזר רק אירועים שנוצרו על ידי אובייקטים השייכים לקבוצות המארחות הנתונות.|
|hostids|string/array|החזר רק אירועים שנוצרו על ידי אובייקטים השייכים למארחים הנתונים.|
|objectids|string/array|החזר רק אירועים שנוצרו על ידי האובייקטים הנתונים.|
|source|integer|החזר רק אירועים עם הסוג הנתון.<br><br>עיין ב[דף אובייקט אירוע](object#event) לקבלת רשימה של סוגי אירועים נתמכים.<br><br>ברירת מחדל: 0 - מפעיל אירועים.|
|object|integer|החזר רק אירועים שנוצרו על ידי אובייקטים מהסוג הנתון.<br><br>עיין ב[דף אובייקט אירוע](object#event) לקבלת רשימה של סוגי אובייקטים נתמכים.<br><br>ברירת מחדל : 0 - טריגר.|
|acknowledged|boolean|אם הוגדר כ-'true' החזר רק אירועים מאושרים.|
|suppressed|boolean|`true` - החזר רק אירועים מודחקים;<br>`false` - החזרת אירועים במצב רגיל.|
|severities|integer/array|החזר רק אירועים עם חומרת אירוע נתונה. חל רק אם האובייקט הוא טריגר.|
|evaltype|integer|כללים לחיפוש תגים.<br><br>ערכים אפשריים:<br>0 - (ברירת מחדל) ו/או;<br>2 - או.|
|תגים|מערך אובייקטים|החזר רק אירועים עם תגיות נתונות. התאמה מדויקת לפי תג וחיפוש לא תלוי רישיות לפי ערך ואופרטור.<br>פורמט: `[{"tag": "<tag>", "value": "<value>", "operator": "<operator> "}, ...]`.<br>מערך ריק מחזיר את כל האירועים.<br><br>סוגי אופרטורים אפשריים:<br>0 - (ברירת מחדל) Like;<br>1 - שווה;<br>2 - לא כמו;<br>3 - לא שווה<br>4 - קיים;<br>5 - לא קיים.|
|eventid\_from|string|החזר רק אירועים עם מזהים שווים או גדולים למזהה הנתון.|
|eventid\_till|string|החזר רק אירועים עם מזהים שווים או נמוכים למזהה הנתון.|
|time\_from|timestamp|החזר רק אירועים שנוצרו לאחר או בזמן הנתון.|
|time\_till|timestamp|החזר רק אירועים שנוצרו לפני או בזמן הנתון.|
|problem\_time\_from|timestamp|מחזיר רק אירועים שהיו במצב הבעיה החל ב-'problem_time_from'. חל רק אם המקור הוא אירוע טריגר והאובייקט הוא טריגר. חובה אם צוין 'זמן_בעיה_עד'.|
|problem\_time\_till|timestamp|מחזיר רק אירועים שהיו במצב הבעיה עד `problem_time_till`. חל רק אם המקור הוא אירוע טריגר והאובייקט הוא טריגר. חובה אם צוין 'זמן_בעיה_מאת'.|
|value|integer/array|החזר רק אירועים עם הערכים הנתונים.|
|selectHosts|query|החזר מאפיין [hosts](/manual/api/reference/host/object) עם מארחים המכילים את האובייקט שיצר את האירוע. נתמך רק עבור אירועים שנוצרו על ידי טריגרים, פריטים או כללי LLD.|
|selectRelatedObject|query|החזר מאפיין `relatedObject` עם האובייקט שיצר את האירוע. סוג האובייקט המוחזר תלוי בסוג האירוע.|
|select\_alerts|query|החזר מאפיין [alerts](/manual/api/reference/alert/object) עם התראות שנוצרו על ידי האירוע. ההתראות ממוינות בסדר כרונולוגי הפוך.|
|select\_acknowledges|query|החזר מאפיין `מאשר` עם עדכוני אירועים. עדכוני אירועים ממוינים בסדר כרונולוגי הפוך.<br><br>אובייקט עדכון האירוע כולל את המאפיינים הבאים:<br>`acknowledgeid` - `(string)` ID acknowledgment;<br>`userid` - `(string) ` מזהה המשתמש שעדכן את האירוע;<br>`eventid` - `(string)` מזהה האירוע המעודכן;<br>`clock` - `(timestamp)` זמן שבו האירוע עודכן;<br> `הודעה` - `(string)` text of the message;<br>`action` - `(integer)` פעולת עדכון שבוצעה ראה [event.acknowledge](/manual/api/reference/event/acknowledge); <br>`old_severity` - `(integer)` חומרת האירוע לפני פעולת העדכון הזו;<br>`new_severity` - `(integer)` חומרת האירוע לאחר פעולת העדכון הזו;<br>`username` - `(string)` שם המשתמש של המשתמש שעדכן את האירוע;<br>`שם` - `(מחרוזת)` שם המשתמש שעדכן את האירוע;<br>`שם משפחה` - `(מחרוזת)` שם המשפחה של המשתמש שעדכן את האירוע .<br><br>תומך ב'ספירה'.|
|selectTags|query|החזר מאפיין [tags](/manual/api/reference/event/object#Event_tag) עם תגי אירועים.|
|selectSuppressionData|query|החזר מאפיין `suppression_data` עם רשימת התחזוקה:<br>`maintenanceid` - `(string)` מזהה התחזוקה;<br>`suppress_until` - `(integer)` זמן עד לאירוע מדוכא.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `eventid`, `objectid` ו-`clock`.|
|countOutput|boolean|הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף [פרשנות הפניה](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|filter|object|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/09930242-99511e47})

[comment]: # ({7223bab1-7223bab1})
### החזר ערכים

`(מספר שלם/מערך)` מחזיר אחד:

- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר `countOutput`
     נעשה שימוש.

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

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

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

[comment]: # ({ffb74bc1-7bd1e923})
#### מאחזר אירועי טריגר

אחזר את האירועים האחרונים מהטריגר "13926".

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "event.get",
     "params": {
         "output": "להרחיב",
         "select_acknowledges": "להאריך",
         "selectTags": "להרחיב",
         "selectSuppressionData": "להרחיב",
         "objectids": "13926",
         "sortfield": ["שעון", "eventid"],
         "sortorder": "DESC"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "eventid": "9695",
             "source": "0",
             "object": "0",
             "objectid": "13926",
             "שעון": "1347970410",
             "value": "1",
             "acknowledged": "1",
             "ns": "413316245",
             "name": "MySQL מושבת",
             "חומרה": "5",
             "r_eventid": "0",
             "c_eventid": "0",
             "correlationid": "0",
             "userid": "0",
             "opdata": "",
             "מאשר": [
                 {
                     "acknowledgeid": "1",
                     "userid": "1",
                     "eventid": "9695",
                     "שעון": "1350640590",
                     "message": "הבעיה נפתרה.\n\r----[אישור בכמות גדולה]----",
                     "action": "6",
                     "old_severity": "0",
                     "new_severity": "0",
                     "username": "מנהל",
                     "name": "Zabix",
                     "שם משפחה": "מנהל"
                 }
             ],
             "suppression_data": [
                 {
                     "maintenanceid": "15",
                     "suppress_until": "1472511600"
                 }
             ],
             "suppressed": "1",
             "תגים": [
                 {
                     "tag": "שירות",
                     "value": "mysqld"
                 },
                 {
                     "tag": "שגיאה",
                     "ערך": ""
                 }
             ]
         },
         {
             "eventid": "9671",
             "source": "0",
             "object": "0",
             "objectid": "13926",
             "שעון": "1347970347",
             "value": "0",
             "acknowledged": "0",
             "ns": "0",
             "name": "לא זמין על ידי ping ICMP",
             "חומרה": "4",
             "r_eventid": "0",
             "c_eventid": "0",
             "correlationid": "0",
             "userid": "0",
             "opdata": "",
             "מאשר": [],
             "suppression_data": [],
             "suppressed": "0",
             "תגים": []
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/ffb74bc1-7bd1e923})

[comment]: # ({8365b6e0-adbe5436})
#### אחזור אירועים לפי פרק זמן

אחזר את כל האירועים שנוצרו בין ה-9 ל-10 באוקטובר,
2012, בסדר כרונולוגי הפוך.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "event.get",
     "params": {
         "output": "להרחיב",
         "time_from": "1349797228",
         "time_till": "1350661228",
         "sortfield": ["שעון", "eventid"],
         "sortorder": "desc"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "eventid": "20616",
             "source": "0",
             "object": "0",
             "objectid": "14282",
             "שעון": "1350477814",
             "value": "1",
             "acknowledged": "0",
             "ns": "0",
             "name": "פחות מ-25% פנויים במטמון ההיסטוריה",
             "חומרה": "3",
             "r_eventid": "0",
             "c_eventid": "0",
             "correlationid": "0",
             "userid": "0",
             "opdata": "",
             "suppressed": "0"
         },
         {
             "eventid": "20617",
             "source": "0",
             "object": "0",
             "objectid": "14283",
             "שעון": "1350477814",
             "value": "0",
             "acknowledged": "0",
             "ns": "0",
             "name": "הלוכד של Zabbix מעבד יותר מ-75% עסוק",
             "חומרה": "3",
             "r_eventid": "0",
             "c_eventid": "0",
             "correlationid": "0",
             "userid": "0",
             "opdata": "",
             "suppressed": "0"
         },
         {
             "eventid": "20618",
             "source": "0",
             "object": "0",
             "objectid": "14284",
             "שעון": "1350477815",
             "value": "1",
             "acknowledged": "0",
             "ns": "0",
             "name": "אובדן פינג גבוה של ICMP",
             "חומרה": "3",
             "r_eventid": "0",
             "c_eventid": "0",
             "correlationid": "0",
             "userid": "0",
             "opdata": "",
             "suppressed": "0"
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/8365b6e0-adbe5436})

[comment]: # ({c6eb3ba0-c6eb3ba0})
### ראה גם

- [התראה](/manual/api/reference/alert/object)
- [פריט](/manual/api/reference/item/object)
- [מארח](/manual/api/reference/host/object)
- [כלל LLD](/manual/api/reference/discoveryrule/object#lld_rule)
- [טריגר](/manual/api/reference/trigger/object)

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

[comment]: # ({f85dc7ca-f85dc7ca})
### מקור

CEvent::get()‎ בתוך *ui/include/classes/api/services/CEvent.php*.

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