[comment]: # translation:outdated

[comment]: # ({a0f60ec7-a0f60ec7})
# role.update

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

[comment]: # ({63875138-63875138})
### Description

`object role.update(object/array roles)`

This method allows to update existing roles.

::: noteclassic
This method is only available to *Super admin* user type.
Permissions to call the method can be revoked in user role settings. See
[User
roles](/manual/web_interface/frontend_sections/administration/user_roles)
for more information.
:::

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

[comment]: # ({039903c0-fa5c3d93})
### פרמטרים

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

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|rules|array|גישה אל [כללים](object#role_rules) כדי להחליף את כללי הגישה הנוכחיים שהוקצו לתפקיד.|

[comment]: # ({/039903c0-fa5c3d93})

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

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

[comment]: # ({/12d196f6-12d196f6})

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

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

[comment]: # ({ba624f03-1ce1fe70})
#### השבתת היכולת לבצע סקריפטים

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

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "role.update",
     "פארמים": [
         {
             "roleid": "5",
             "כללים": {
                 "פעולות": [
                     {
                         "name": "execute_scripts",
                         "סטטוס": "0"
                     }
                 ]
             }
         }
     ],
     "auth": "3a57200802b24cda67c4e4010b50c065",
     "מזהה": 1
}
```

תְגוּבָה:

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

[comment]: # ({/ba624f03-1ce1fe70})

[comment]: # ({9a05bab8-a6349165})
#### הגבלת גישה ל-API

עדכן תפקיד עם מזהה "5", דחה לקרוא לכל "צור", "עדכן" או "מחק"
שיטות.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "role.update",
     "פארמים": [
         {
             "roleid": "5",
             "כללים": {
                 "api.access": "1",
                 "api.mode": "0",
                 "api": ["*.create", "*.update", "*.delete"]
             }
         }
     ],
     "auth": "3a57200802b24cda67c4e4010b50c065",
     "מזהה": 1
}
```

תְגוּבָה:

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

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

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

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

[comment]: # ({/36db1bd2-36db1bd2})