אירוע.אשר
תיאור
object event.acknowledge(פרמטרי אובייקט/מערך)
שיטה זו מאפשרת לעדכן אירועים. פעולות העדכון הבאות יכולות להיות מְבוּצָע:
- אירוע סגור. אם האירוע כבר נפתר, פעולה זו תהיה דילג.
- אישור לאירוע. אם האירוע כבר מאושר, פעולה זו ידלג.
- בטל אישור לאירוע. אם האירוע לא יאושר, פעולה זו תידלג.
- הוסף הודעה.
- שנה את חומרת האירוע. אם לאירוע כבר יש אותה חומרה, זה הפעולה תידלג.
::: הערה חשוב
ניתן לעדכן רק אירועי טריגר.
ניתן לעדכן רק אירועי בעיה.
נדרשות זכויות קריאה/כתיבה עבור טריגר כדי לסגור את האירוע או כדי
שנה את חומרת האירוע.
כדי לסגור אירוע, יש לאפשר סגירה ידנית ב-
הדק.
:::
שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.
פרמטרים
(אובייקט/מערך) פרמטרים המכילים את מזהי האירועים והעדכון
פעולות שצריך לבצע.
| פרמטר | סוג | תיאור |
|---|---|---|
| eventids (נדרש) |
string/object | מזהים של האירועים שיש לאשר. |
| פעולה (נדרש) |
מספר שלם | פעולת עדכון אירוע. זהו שדה מסיכת סיביות, כל שילוב של ערכים מקובל. ערכים אפשריים: 1 - בעיה סגורה; 2 - אישור אירוע; 4 - הוסף הודעה; 8 - שינוי חומרת; 16 - ביטול אישור אירוע. |
| message | string | טקסט של ההודעה. חובה, אם הפעולה מכילה דגל 'הוסף הודעה'. |
| severity | integer | חומרה חדשה לאירועים. חובה, אם הפעולה מכילה דגל 'שנה חומרה'. ערכים אפשריים: 0 - לא מסווג; 1 - מידע; 2 - אזהרה; 3 - ממוצע; 4 - גבוה; 5 - אסון. |
החזר ערכים
(אובייקט) מחזיר אובייקט המכיל את המזהים של האירועים המעודכנים
תחת מאפיין 'eventids'.
דוגמאות
הכרה באירוע
אשרו אירוע בודד והשאירו הודעה.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": "20427",
"פעולה": 6,
"message": "הבעיה נפתרה."
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}
תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": {
"eventids": [
"20427"
]
},
"מזהה": 1
}
שינוי חומרת האירוע
שנה חומרה עבור מספר אירועים והשאיר הודעה.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "event.acknowledge",
"params": {
"eventids": ["20427", "20428"],
"פעולה": 12,
"message": "נדרשת תחזוקה כדי לתקן את זה.",
"חומרה": 4
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}
תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": {
"eventids": [
"20427",
"20428"
]
},
"מזהה": 1
}
מקור
CEvent::acknowledge() בתוך ui/include/classes/api/services/CEvent.php.