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.