אירוע.אשר

תיאור

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.