[comment]: # ({66c5a546-66c5a546})
# host.massadd

[comment]: # ({/66c5a546-66c5a546})

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

`object host.massadd(אובייקט פרמטרים)`

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

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

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

[comment]: # ({0ac2d1c4-c25e2be4})
### פרמטרים

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

השיטה מקבלת את הפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**מארחים**<br>(חובה)|object/array|מארחים שיש לעדכן.<br><br>על המארחים להיות מוגדר המאפיין `hostid`.|
|groups|object/array|קבוצות מארחות להוספה למארחים הנתונים.<br><br>לקבוצות המארחות חייב להיות מוגדר המאפיין `groupid`.|
|interfaces|object/array|[ממשקי מארח](/manual/api/reference/hostinterface/object) שייווצרו עבור המארחים הנתונים.|
|macros|object/array|[פקודות מאקרו משתמש](/manual/api/reference/usermacro/object) שייווצרו עבור המארחים הנתונים.|
|templates|object/array|תבניות לקישור למארחים הנתונים.<br><br>תבניות חייבות להיות מוגדרות המאפיין 'templateid'.|

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

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

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

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

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

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

[comment]: # ({f170f1a8-453a1298})
#### הוספת פקודות מאקרו

הוסף שתי פקודות מאקרו חדשות לשני מארחים.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "host.massadd",
     "params": {
         "מארחים": [
             {
                 "hostid": "10160"
             },
             {
                 "hostid": "10167"
             }
         ],
         "מאקרו": [
             {
                 "macro": "{$TEST1}",
                 "value": "MACROTEST1"
             },
             {
                 "macro": "{$TEST2}",
                 "value": "MACROTEST2",
                 "description": "תיאור הבדיקה"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/f170f1a8-453a1298})

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

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

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

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

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

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