[comment]: # translation:outdated

[comment]: # ({0d3af930-0d3af930})
# תחזוקה.קבל

[comment]: # ({/0d3af930-0d3af930})

[comment]: # ({9fad91e3-a04dd4c9})
### תיאור

`integer/array maintenance.get(אובייקט פרמטרים)`

השיטה מאפשרת לאחזר תחזוקה לפי הנתון
פרמטרים.

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

[comment]: # ({/9fad91e3-a04dd4c9})

[comment]: # ({869dcabb-9ca798d7})
### פרמטרים

`(object)` פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|groupids|string/array|החזר רק תחזוקה שהוקצו לקבוצות המארחות הנתונות.|
|hostids|string/array|החזר רק תחזוקה שהוקצו למארחים הנתונים.|
|maintenanceids|string/array|החזר רק תחזוקה עם המזהים הנתונים.|
|selectGroups|query|החזר מאפיין [groups](/manual/api/reference/hostgroup/object) עם קבוצות מארחות שהוקצו לתחזוקה.|
|selectHosts|query|החזר מאפיין [hosts](/manual/api/reference/host/object) עם מארחים שהוקצו לתחזוקה.|
|selectTags|query|החזר מאפיין [tags](/manual/api/reference/maintenance/object#problem_tag) עם תגיות בעיה של התחזוקה.|
|selectTimeperiods|query|החזר מאפיין [timeperiods](/manual/api/reference/maintenance/object#Time_period) עם פרקי זמן של תחזוקה.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `maintenanceid`, `name` ו`maintenance_type`.|
|countOutput|boolean|הפרמטרים הללו, המשותפים לכל שיטות ה-'get', מתוארים בפירוט ב[פירוש ההתייחסות](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|filter|object|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|בוליאני|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/869dcabb-9ca798d7})

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

`(מספר שלם/מערך)` מחזיר אחד:

- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר `countOutput`
     נעשה שימוש.

[comment]: # ({/7223bab1-7223bab1})

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

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

[comment]: # ({3a07a8f9-0b1cb387})
#### אחזור תחזוקה

אחזר את כל התחזוקה שהוגדרה, ואת הנתונים על המוקצים
קבוצות מארחות, פרקי זמן מוגדרים ותגי בעיה.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "maintenance.get",
     "params": {
         "output": "להרחיב",
         "selectGroups": "להרחיב",
         "selectTimeperiods": "להאריך",
         "selectTags": "להרחיב"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "maintenanceid": "3",
             "name": "תחזוקה ביום ראשון",
             "maintenance_type": "0",
             "תיאור": "",
             "active_since": "1358844540",
             "active_till": "1390466940",
             "tags_evaltype": "0",
             "קבוצות": [
                 {
                     "groupid": "4",
                     "name": "שרתי Zabbix",
                     "internal": "0"
                 }
             ],
             "תקופות זמן": [
                 {
                     "timeperiod_type": "3",
                     "כל": "1",
                     "month": "0",
                     "dayofweek": "1",
                     "day": "0",
                     "start_time": "64800",
                     "period": "3600",
                     "start_date": "2147483647"
                 }
             ],
             "תגים": [
                 {
                     "tag": "שירות",
                     "מפעיל": "0",
                     "value": "mysqld",
                 },
                 {
                     "tag": "שגיאה",
                     "מפעיל": "2",
                     "ערך": ""
                 }
             ]
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/3a07a8f9-0b1cb387})

[comment]: # ({dbcf678a-dbcf678a})
### ראה גם

- [מארח](/manual/api/reference/host/object#host)
- [קבוצת מארח](/manual/api/reference/hostgroup/object#host_group)
- [תקופת זמן](object#time_period)

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

[comment]: # ({50ed5be3-50ed5be3})
### מקור

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

[comment]: # ({/50ed5be3-50ed5be3})