[comment]: # ({f47b150e-f47b150e})
# תחזוקה.ליצור

[comment]: # ({/f47b150e-f47b150e})

[comment]: # ({e8498ebc-e8498ebc})
### תיאור

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

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

::: noteclassic
שיטה זו זמינה רק ל-*Admin* ו-*Super Admin*
סוגי משתמשים. ניתן לבטל הרשאות לקרוא לשיטה בתפקיד משתמש
הגדרות. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/e8498ebc-e8498ebc})

[comment]: # ({2ee5c088-6c14daac})
### פרמטרים

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|groups|object/array|מארח [groups](/manual/api/reference/hostgroup/object) שיעבור תחזוקה.<br><br>לקבוצות המארחות יש להגדיר את המאפיין 'groupid'.<br><br> br>יש לציין לפחות אובייקט אחד של 'קבוצות' או 'מארחים'.|
|hosts|object/array|[hosts](/manual/api/reference/host/object) שיעברו תחזוקה.<br><br>המארחים חייבים להיות בעלי מאפיין `hostid` מוגדר.<br><br> יש לציין לפחות אובייקט אחד של 'קבוצות' או 'מארחים'.|
|**תקופות זמן**<br>(חובה)|object/array|תחזוקה [תקופות זמן](/manual/api/reference/maintenance/object#time_period).|
|tags|object/array|[תגי בעיה](/manual/api/reference/maintenance/object#problem_tag).<br><br>הגדר אילו בעיות יש לדכא.<br>אם לא ניתנים תגים, כולם פעילים בעיות מארח תחזוקה ידחקו.|
|groupids<br>(הוצא משימוש)|מערך|פרמטר זה הוצא משימוש, אנא השתמש ב'קבוצות' במקום זאת.<br>מזהים של הקבוצות המארחות שיעברו תחזוקה.|
|hostids<br>(מבוטל)|מערך|פרמטר זה הוצא משימוש, אנא השתמש ב-'hosts' במקום זאת.<br>מזהים של המארחים שיעברו תחזוקה.|

[comment]: # ({/2ee5c088-6c14daac})

[comment]: # ({48c4869c-48c4869c})
### החזר ערכים

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

[comment]: # ({/48c4869c-48c4869c})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({642cb053-bb812c67})
#### יצירת תחזוקה

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

בַּקָשָׁה:

``` json
{
     "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
}
```

תְגוּבָה:

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

[comment]: # ({/642cb053-bb812c67})

[comment]: # ({82b3ef0e-82b3ef0e})
### מידע נוסף

-   [משך זמן](object#time_period)

[comment]: # ({/82b3ef0e-82b3ef0e})

[comment]: # ({3e3a556f-3e3a556f})
### מקור

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

[comment]: # ({/3e3a556f-3e3a556f})