[comment]: # translation:outdated

[comment]: # ({2ccfd922-2ccfd922})
# אירוע.אשר

[comment]: # ({/2ccfd922-2ccfd922})

[comment]: # ({3cf9db19-eed7fdda})
### תיאור

`object event.acknowledge(פרמטרי אובייקט/מערך)`

שיטה זו מאפשרת לעדכן אירועים. פעולות העדכון הבאות יכולות להיות
מְבוּצָע:

- אירוע סגור. אם האירוע כבר נפתר, פעולה זו תהיה
     דילג.
- אישור לאירוע. אם האירוע כבר מאושר, פעולה זו
     ידלג.
- בטל אישור לאירוע. אם האירוע לא יאושר, פעולה זו תידלג.
-   הוסף הודעה.
- שנה את חומרת האירוע. אם לאירוע כבר יש אותה חומרה, זה
     הפעולה תידלג.

::: הערה חשוב
ניתן לעדכן רק אירועי טריגר.\
ניתן לעדכן רק אירועי בעיה.\
נדרשות זכויות קריאה/כתיבה עבור טריגר כדי לסגור את האירוע או כדי
שנה את חומרת האירוע.\
כדי לסגור אירוע, יש לאפשר סגירה ידנית ב-
הדק.
:::

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

[comment]: # ({/3cf9db19-eed7fdda})

[comment]: # ({4f7f6cc3-32560b88})
### פרמטרים

`(אובייקט/מערך)` פרמטרים המכילים את מזהי האירועים והעדכון
פעולות שצריך לבצע.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**eventids**<br>(נדרש)|string/object|מזהים של האירועים שיש לאשר.|
|**פעולה**<br>(נדרש)|מספר שלם|פעולת עדכון אירוע. זהו שדה מסיכת סיביות, כל שילוב של ערכים מקובל.<br><br>ערכים אפשריים:<br>1 - בעיה סגורה;<br>2 - אישור אירוע;<br>4 - הוסף הודעה;<br>8 - שינוי חומרת;<br>16 - ביטול אישור אירוע.|
|message|string|טקסט של ההודעה.<br>**חובה**, אם הפעולה מכילה דגל 'הוסף הודעה'.|
|severity|integer|חומרה חדשה לאירועים.<br>**חובה**, אם הפעולה מכילה דגל 'שנה חומרה'.<br><br>ערכים אפשריים:<br>0 - לא מסווג;<br>1 - מידע;<br>2 - אזהרה;<br>3 - ממוצע;<br>4 - גבוה;<br>5 - אסון.|

[comment]: # ({/4f7f6cc3-32560b88})

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

`(אובייקט)` מחזיר אובייקט המכיל את המזהים של האירועים המעודכנים
תחת מאפיין 'eventids'.

[comment]: # ({/94f3ab84-94f3ab84})

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

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

[comment]: # ({2a20eeea-9e923e4c})
#### הכרה באירוע

אשרו אירוע בודד והשאירו הודעה.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "event.acknowledge",
     "params": {
         "eventids": "20427",
         "פעולה": 6,
         "message": "הבעיה נפתרה."
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "eventids": [
             "20427"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/2a20eeea-9e923e4c})

[comment]: # ({7d16988e-94e25d7e})
#### שינוי חומרת האירוע

שנה חומרה עבור מספר אירועים והשאיר הודעה.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "event.acknowledge",
     "params": {
         "eventids": ["20427", "20428"],
         "פעולה": 12,
         "message": "נדרשת תחזוקה כדי לתקן את זה.",
         "חומרה": 4
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "eventids": [
             "20427",
             "20428"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/7d16988e-94e25d7e})

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

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

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