This is a translation of the original English documentation page. Help us make it better.

role.update

Description

object role.update(object/array roles)

This method allows to update existing roles.

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 for more information.

פרמטרים

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

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

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

פרמטר סוג תיאור
rules array גישה אל כללים כדי להחליף את כללי הגישה הנוכחיים שהוקצו לתפקיד.

החזר ערכים

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

דוגמאות

השבתת היכולת לבצע סקריפטים

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

בַּקָשָׁה:

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

תְגוּבָה:

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

הגבלת גישה ל-API

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

בַּקָשָׁה:

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

תְגוּבָה:

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

מקור

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