role.update

Descrizione

object role.update(object/array roles)

Questo metodo consente di aggiornare i ruoli esistenti.

Questo metodo è disponibile solo per il tipo di utente Super admin. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere Ruoli utente per ulteriori informazioni.

Parametri

(object/array) Proprietà del ruolo da aggiornare.

La proprietà roleid deve essere definita per ciascun ruolo, tutte le altre proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre rimarranno invariate.

Oltre alle proprietà standard del ruolo, il metodo accetta i seguenti parametri.

Parametro Tipo Descrizione
rules array Regole di accesso da aggiornare per il ruolo.

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID dei ruoli aggiornati sotto la proprietà roleids.

Esempi

Disabilitazione della possibilità di eseguire script

Aggiorna il ruolo con ID "5", disabilitando la possibilità di eseguire script.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "role.update",
    "params": [
        {
            "roleid": "5",
            "rules": {
                "actions": [
                    {
                        "name": "execute_scripts",
                        "status": "0"
                    }
                ]
            }
        }
    ],
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "roleids": [
            "5"
        ]
    },
    "id": 1
}

Limitazione dell'accesso all'API

Aggiorna il ruolo con ID "5", negando la chiamata di qualsiasi metodo "create", "update" o "delete".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "role.update",
    "params": [
        {
            "roleid": "5",
            "rules": {
                "api.access": "1",
                "api.mode": "0",
                "api": ["*.create", "*.update", "*.delete"]
            }
        }
    ],
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "roleids": [
            "5"
        ]
    },
    "id": 1
}

Fonte

CRole::update() in ui/include/classes/api/services/CRole.php.