role.update
Opis
object role.update(object/array roles)
Ta metoda pozwala na aktualizację istniejących ról.
Ta metoda jest dostępna tylko dla typu użytkownika Super admin. Uprawnienia do wywołania metody można cofnąć w ustawieniach ról użytkownika. Zobacz Role użytkowników aby uzyskać więcej informacji.
Parametry
(object/array) Właściwości roli do zaktualizowania.
Właściwość roleid musi być zdefiniowana dla każdej roli, wszystkie inne
właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, wszystkie
inne pozostaną niezmienione.
Oprócz standardowych właściwości roli metoda akceptuje następujące parametry.
| Parametr | Typ | Opis |
|---|---|---|
| rules | array | Zasady reguł dostępu, które mają zastąpić obecne zasady dostępu przypisane do roli. |
Zwracane wartości
(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych ról
we właściwość roleids.
Przykłady
Wyłączanie możliwości wykonywania skryptów
Zaktualizuj rolę o identyfikatorze "5", wyłączając możliwość wykonywania skryptów.
Zapytanie:
{
"jsonrpc": "2.0",
"method": "role.update",
"params": [
{
"roleid": "5",
"rules": {
"actions": [
{
"name": "execute_scripts",
"status": "0"
}
]
}
}
],
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"roleids": [
"5"
]
},
"id": 1
}Ograniczanie dostępu do interfejsu API
Zaktualizuj rolę o identyfikatorze "5", uniemożliwiając wywołanie dowolnych metod "create", "update" lub "delete".
Zapytanie:
{
"jsonrpc": "2.0",
"method": "role.update",
"params": [
{
"roleid": "5",
"rules": {
"api.access": "1",
"api.mode": "0",
"api": ["*.create", "*.update", "*.delete"]
}
}
],
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}Odpowiedź:
{
"jsonrpc": "2.0",
"result": {
"roleids": [
"5"
]
},
"id": 1
}Źródło
CRole::update() w ui/include/classes/api/services/CRole.php.