[comment]: # ({2a0a5084-2a0a5084})
# host.massremove

[comment]: # ({/2a0a5084-2a0a5084})

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

`object host.massremove(object parameters)`

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

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

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

[comment]: # ({c619f2cd-689d39a3})
### פרמטרים

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**מארחים**<br>(נדרש)|מחרוזת/מערך|מזהים של המארחים שיש לעדכן.|
|groupids|string/array|קבוצות מארחות להסרת המארחים הנתונים.|
|interfaces|object/array|ממשקי מארח להסרה מהמארחים הנתונים.<br><br>לאובייקט ממשק המארח חייבים להיות מוגדרים המאפיינים `ip`, `dns` ו-`port`.|
|macros|string/array|פקודות מאקרו של משתמש למחיקה מהמארחים הנתונים.|
|templateids|string/array|תבניות לביטול הקישור מהמארחים הנתונים.|
|templateids\_clear|string/array|תבניות לביטול קישור וניקוי מהמארחים הנתונים.|

[comment]: # ({/c619f2cd-689d39a3})

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

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

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

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

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

[comment]: # ({476c58e8-8c635a7b})
#### ביטול קישור תבניות

בטל קישור של תבנית משני מארחים ומחק את כל התבנית
ישויות.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "host.massremove",
     "params": {
         "hostids": ["69665", "69666"],
         "templateids_clear": "325"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "hostids": [
             "69665",
             "69666"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/476c58e8-8c635a7b})

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

- [host.update](עדכון)
- [משתמש
     מאקרו](/manual/api/reference/usermacro/object#hosttemplate_level_macro)
-   [מנחה
     ממשק](/manual/api/reference/hostinterface/object#host_interface)

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

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

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

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