אירוע.אשר

תיאור

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.