action.create

תיאור

object action.create(object/array actions)

מתודה זו מאפשרת ליצור פעולות חדשות.

מתודה זו זמינה רק לסוגי המשתמשים מנהלים ומנהלי על. אפשר לשלול את הרשאות הקריאה למתודה בהגדרות תפקיד המשתמש. למידע נוסף ניתן לפנות אל תפקידי משתמשים.

פרמטרים

(אובייקט/מערך) פעולות ליצירה.

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

פרמטר סוג תיאור
filter object Action filter אובייקט עבור הפעולה.
operations מערך פעולה פעולות ליצירה עבור הפעולה.
recovery_operations מערך פעולה פעולות שחזור ליצירה עבור הפעולה.
update_operations מערך פעולה פעולות עדכון ליצירה עבור הפעולה.

ערכים חוזרים

(object) מחזירה פריט שמכיל את מס׳ הזיהוי של הפעולות שנוצרו תחת המאפיין actionids. סדר מס׳ הזיהוי שהוחזרו תואם לסדר הפעולות שהועברו.

דוגמאות

צור פעולת טריגר

צור פעולת טריגר שתתחיל ברגע שטריגר (עם המילה "זיכרון" בשמה) מהמארח "10084" נכנס למצב PROBLEM. לפעולה יהיו 4 פעולות מוגדרות. הפעולה הראשונה והמיידית תשלח הודעה לכל המשתמשים בקבוצת המשתמש "7" באמצעות מדיה מסוג "1". אם האירוע לא ייפתר תוך 30 דקות, הפעולה השנייה תפעיל את script "5" (סקריפט עם היקף "פעולת פעולה") על כל המארחים בקבוצה "2". אם האירוע נפתר, פעולת שחזור תודיע לכל המשתמשים שקיבלו הודעות כלשהן בנוגע לבעיה. אם האירוע מתעדכן, פעולת אישור/עדכון תודיע (עם נושא והודעה מותאמת אישית) לכל המשתמשים שקיבלו הודעות כלשהן בנוגע לבעיה.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "action.create",
            "params": {
                "name": "פעולת טריגר",
                "מקור אירועים": 0,
                "esc_period": "30 מ'",
                "מסנן": {
                    "evaltype": 0,
                    "תנאים": [
                        {
                            "סוג מצב": 1,
                            "מפעיל": 0,
                            "value": "10084"
                        },
                        {
                            "סוג מצב": 3,
                            "מפעיל": 2,
                            "value": "זיכרון"
                        }
                    ]
                },
                "פעולות": [
                    {
                        "סוג פעולה": 0,
                        "esc_step_from": 1,
                        "esc_step_to": 1,
                        "opmessage_grp": [
                            {
                                "usrgrpid": "7"
                            }
                        ],
                        "opmessage": {
                            "default_msg": 1,
                            "mediatypeid": "1"
                        }
                    },
                    {
                        "סוג פעולה": 1,
                        "esc_step_from": 2,
                        "esc_step_to": 2,
                        "תנאים אופקיים": [
                            {
                                "סוג מצב": 14,
                                "מפעיל": 0,
                                "value": "0"
                            }
                        ],
                        "opcommand_grp": [
                            {
                                "groupid": "2"
                            }
                        ],
                        "opcommand": {
                            "scriptid": "5"
                        }
                    }
                ],
                "פעולות_שחזור": [
                    {
                        "operationtype": "11",
                        "opmessage": {
                            "default_msg": 1
                        }
                    }
                ],
                "עדכון_פעולות": [
                    {
                        "operationtype": "12",
                        "opmessage": {
                            "default_msg": 0,
                            "message": "גוף הודעת פעולת עדכון מותאם אישית",
                            "subject": "נושא הודעת פעולת עדכון מותאם אישית"
                        }
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "actionids": [
                    "17"
                ]
            },
            "מזהה": 1
       }

צור פעולת גילוי

צור פעולת גילוי שתקשר מארחים שהתגלו לתבנית "10001".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "action.create",
            "params": {
                "name": "פעולת גילוי",
                "מקור אירועים": 1,
                "מסנן": {
                    "evaltype": 0,
                    "תנאים": [
                        {
                            "סוג מצב": 21,
                            "מפעיל": 0,
                            "value": "1"
                        },
                        {
                            "סוג מצב": 10,
                            "מפעיל": 0,
                            "value": "2"
                        }
                    ]
                },
                "פעולות": [
                    {
                        "סוג פעולה": 6,
                        "optemplate": [
                            {
                                "templateid": "10001"
                            }
                        ]
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "actionids": [
                    "18"
                ]
            },
            "מזהה": 1
       }

שימוש במסנן ביטויים מותאם אישית

צור פעולת טריגר המשתמשת בביטוי מותאם אישית - "A ו-(B או C)" - להערכת תנאי הפעולה. ברגע שטריגר עם חומרה גבוהה או שווה ל"אזהרה" מהמארח "10084" או מארח "10106" נכנס למצב PROBLEM, הפעולה תשלח הודעה לכל המשתמשים בקבוצת המשתמשים "7" באמצעות מדיה מסוג "1". מזהי הנוסחה "A", "B" ו-"C" נבחרו באופן שרירותי.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "action.create",
            "params": {
                "name": "פעולת טריגר",
                "מקור אירועים": 0,
                "esc_period": "15 מ'",
                "מסנן": {
                    "evaltype": 3,
                    "formula": "A ו-(B או C)",
                    "תנאים": [
                        {
                            "סוג מצב": 4,
                            "מפעיל": 5,
                            "value": "2",
                            "formulaid": "א"
                        },
                        {
                            "סוג מצב": 1,
                            "מפעיל": 0,
                            "value": "10084",
                            "formulaid": "B"
                        },
                        {
                            "סוג מצב": 1,
                            "מפעיל": 0,
                            "value": "10106",
                            "formulaid": "C"
                        }
                    ]
                },
                "פעולות": [
                    {
                        "סוג פעולה": 0,
                        "esc_step_from": 1,
                        "esc_step_to": 1,
                        "opmessage_grp": [
                            {
                                "usrgrpid": "7"
                            }
                        ],
                        "opmessage": {
                            "default_msg": 1,
                            "mediatypeid": "1"
                        }
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "actionids": [
                    "18"
                ]
            },
            "מזהה": 1
       }

צור כלל רישום אוטומטי של סוכן

צור פעולת רישום אוטומטי שמוסיפה מארח לקבוצת המארח "2" כאשר שם המארח מכיל "SRV" או מטא נתונים מכילים "AlmaLinux".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "action.create",
            "params": {
                "name": "רשום שרתי לינוקס",
                "eventsource": "2",
                "מסנן": {
                    "evaltype": "2",
                    "תנאים": [
                        {
                            "conditiontype": "22",
                            "מפעיל": "2",
                            "value": "SRV"
                        },
                        {
                            "conditiontype": "24",
                            "מפעיל": "2",
                            "value": "AlmaLinux"
                        }
                    ]
                },
                "פעולות": [
                    {
                        "operationtype": "4",
                        "opgroup": [
                            {
                                "groupid": "2"
                            }
                        ]
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "actionids": [
                    19
                ]
            },
            "מזהה": 1
       }

ראה גם

מקור

CAction::create()‎ בתוך ui/include/classes/api/services/CAction.php.