[comment]: # ({5ebe3ff8-5ebe3ff8})
# hostgroup.create

[comment]: # ({/5ebe3ff8-5ebe3ff8})

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

`object hostgroup.create(object/array hostGroups)`

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

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

[comment]: # ({/06c5b0b6-06c5b0b6})

[comment]: # ({7c6d41ff-7c6d41ff})
### פרמטרים

`(אובייקט/מערך)` מארח קבוצות ליצירה. השיטה מקבלת קבוצות מארחות
עם [מאפייני קבוצת המארח הסטנדרטיים](object#host_group).

[comment]: # ({/7c6d41ff-7c6d41ff})

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

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

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

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

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

[comment]: # ({822c3285-37cc26c2})
#### יצירת קבוצה מארחת

צור קבוצה מארחת בשם "שרתי לינוקס".

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "hostgroup.create",
     "params": {
         "name": "שרתי לינוקס"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/822c3285-37cc26c2})

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

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

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