role.update

Opis

object role.update(object/array roles)

Ta metoda umożliwia aktualizację istniejących ról.

Ta metoda jest dostępna wyłącznie dla typu użytkownika Super admin. Uprawnienia do wywoływania tej metody można odebrać w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object/array) Właściwości roli do zaktualizowania.

Właściwość roleid musi być zdefiniowana dla każdej roli, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Oprócz standardowych właściwości roli metoda akceptuje następujące parametry.

Parametr Type Opis
rules array Reguły dostępu rules do zaktualizowania dla roli.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych ról we właściwości roleids.

Przykłady

Wyłączanie możliwości wykonywania skryptów

Zaktualizuj rolę o ID „5”, wyłącz możliwość wykonywania skryptów.

Żądanie:

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

Odpowiedź:

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

Ograniczanie dostępu do API

Zaktualizuj rolę o ID „5”, zabraniając wywoływania dowolnych metod „create”, „update” lub „delete”.

Żądanie:

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

Odpowiedź:

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

Źródło

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