תחזוקה.ליצור

תיאור

object maintenance.create(תחזוקה של אובייקט/מערך)

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

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

פרמטרים

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

בנוסף לתחזוקה הרגילה properties](object#maintenance), השיטה מקבלת את הדברים הבאים פרמטרים.

פרמטר סוג תיאור
groups object/array מארח groups שיעבור תחזוקה.

לקבוצות המארחות יש להגדיר את המאפיין 'groupid'.

br>יש לציין לפחות אובייקט אחד של 'קבוצות' או 'מארחים'.
hosts object/array hosts שיעברו תחזוקה.

המארחים חייבים להיות בעלי מאפיין hostid מוגדר.

יש לציין לפחות אובייקט אחד של 'קבוצות' או 'מארחים'.
תקופות זמן
(חובה)
object/array תחזוקה תקופות זמן.
tags object/array תגי בעיה.

הגדר אילו בעיות יש לדכא.
אם לא ניתנים תגים, כולם פעילים בעיות מארח תחזוקה ידחקו.
groupids
(הוצא משימוש)
מערך פרמטר זה הוצא משימוש, אנא השתמש ב'קבוצות' במקום זאת.
מזהים של הקבוצות המארחות שיעברו תחזוקה.
hostids
(מבוטל)
מערך פרמטר זה הוצא משימוש, אנא השתמש ב-'hosts' במקום זאת.
מזהים של המארחים שיעברו תחזוקה.

החזר ערכים

(אובייקט) מחזיר אובייקט המכיל את המזהים של היצירה שנוצרה תחזוקה תחת נכס תחזוקה. הסדר של ה תעודות זהות שהוחזרו תואמות את סדר התחזוקה שעברו.

דוגמאות

יצירת תחזוקה

צור תחזוקה עם איסוף נתונים לקבוצה מארחת עם מזהה "2" ועם תגי בעיה service:mysqld ושגיאה. זה חייב להיות פעיל מ 22.01.2013 עד 22.01.2014, ייכנסו לתוקף בכל יום ראשון בשעה 18:00 ועד אחרון לשעה אחת.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "maintenance.create",
            "params": {
                "name": "תחזוקה ביום ראשון",
                "active_since": 1358844540,
                "פעיל_עד": 1390466940,
                "tags_evaltype": 0,
                "קבוצות": [
                    {"groupid": "2"}
                ],
                "תקופות זמן": [
                    {
                        "תקופה": 3600,
                        "timeperiod_type": 3,
                        "זמן_התחלה": 64800,
                        "כל": 1,
                        "יום בשבוע": 64
                    }
                ],
                "תגים": [
                    {
                        "tag": "שירות",
                        "מפעיל": "0",
                        "value": "mysqld"
                    },
                    {
                        "tag": "שגיאה",
                        "מפעיל": "2",
                        "ערך": ""
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "תחזוקה": [
                    "3"
                ]
            },
            "מזהה": 1
       }

מידע נוסף

מקור

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