[comment]: # ({c0df6427-c0df6427})
# hostprototype.update

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

[comment]: # ({8ae04b29-796670ab})
### תיאור

`object hostprototype.update(object/array hostPrototypes)`

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

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

[comment]: # ({/8ae04b29-796670ab})

[comment]: # ({2d0e622f-50727275})
### פרמטרים

`(אובייקט/מערך)` יש לעדכן מאפייני אב טיפוס מארח.

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|groupLinks|מערך|קבוצת [קישורים](/manual/api/reference/hostprototype/object#group_link) כדי להחליף את קישורי הקבוצה הנוכחיים באב הטיפוס המארח.|
|groupPrototypes|מערך|קבוצה [אבי טיפוס](/manual/api/reference/hostprototype/object#group_prototype) כדי להחליף את אבות הטיפוס הקיימים של הקבוצה באב הטיפוס המארח.|
|macros|object/array|[פקודות מאקרו משתמש](/manual/api/reference/usermacro/object) להחלפת פקודות המאקרו הנוכחיות של המשתמש.<br><br>כל פקודות המאקרו שאינן רשומות בבקשה יוסרו.|
|tags|object/array|אב-טיפוס מארח [tags](/manual/api/reference/hostprototype/object#host_prototype_tag) כדי להחליף את התגים הנוכחיים.<br><br>כל התגים שאינם רשומים בבקשה יוסרו .|
|interfaces|object/array|אב-טיפוס מארח [ממשקים מותאמים אישית](/manual/api/reference/hostprototype/object#custom_interface) כדי להחליף את הממשקים הנוכחיים.<br><br>אובייקט ממשק מותאם אישית צריך להכיל את כל הפרמטרים שלו.<br >כל הממשקים שאינם רשומים בבקשה יוסרו.|
|templates|object/array|[Templates](/manual/api/reference/template/object) כדי להחליף את התבניות המקושרות כעת.<br><br>התבניות חייבות להיות מוגדרות במאפיין `templateid`.|

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

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

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

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

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

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

[comment]: # ({e62973ef-9e34a671})
#### השבתת אב טיפוס מארח

השבת אב טיפוס מארח, כלומר, הגדר את המצב שלו ל-1.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "hostprototype.update",
     "params": {
         "hostid": "10092",
         "סטטוס": 1
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

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

[comment]: # ({cc816645-440003e2})
#### עדכון תגי אב טיפוס מארח

החלף תגיות אב טיפוס מארח בתגיות חדשות.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "hostprototype.update",
     "params": {
         "hostid": "10092",
         "תגים": [
             {
                 "tag": "מרכז נתונים",
                 "value": "{#DATACENTER.NAME}"
             },
             {
                 "tag": "סוג מופע",
                 "value": "{#INSTANCE_TYPE}"
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/cc816645-440003e2})

[comment]: # ({5e77fe89-7a7b18a4})
אב

[comment]: # ({/5e77fe89-7a7b18a4})

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

- [קישור קבוצתי](object#group_link)
- [אב-טיפוס קבוצתי](object#group_prototype)
- [תג אב טיפוס מארח](object#host_prototype_tag)
- [ממשק מותאם אישית](object#custom_interface)
- [משתמש
     מאקרו](/manual/api/reference/usermacro/object#hosttemplate_level_macro)

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

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

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

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