usergroup.update

Opis

object usergroup.update(object/array userGroups)

Ta metoda umożliwia aktualizację istniejących grup użytkowników.

Ta metoda jest dostępna tylko dla typu użytkownika Super admin. Uprawnienia do wywołania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.

Parametry

(object/array) Właściwości grup użytkowników do zaktualizowania.

Właściwość usrgrpid musi być zdefiniowana dla każdej grupy użytkowników, 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 grup użytkowników, metoda akceptuje następujące parametry.

Parametr Typ Opis
hostgroup_rights object/array Uprawnienia do grup hostów, które zastąpią bieżące uprawnienia przypisane do grupy użytkowników.
templategroup_rights object/array Uprawnienia do grup szablonów, które zastąpią bieżące uprawnienia przypisane do grupy użytkowników.
tag_filters array Uprawnienia oparte na tagach, które zastąpią bieżące uprawnienia przypisane do grupy użytkowników.
users object/array Użytkownicy, którzy zastąpią bieżących użytkowników przypisanych do grupy użytkowników.

Użytkownik musi mieć zdefiniowaną tylko właściwość userid.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych grup użytkowników we właściwości usrgrpids.

Przykłady

Włączanie grupy użytkowników i aktualizacja uprawnień

Włącz grupę użytkowników i zapewnij jej dostęp do odczytu i zapisu do grup hostów „2” i „4”.

Żądanie:

{
    "jsonrpc": "2.0",
    "method": "usergroup.update",
    "params": {
        "usrgrpid": "17",
        "users_status": "0",
        "hostgroup_rights": [
            {
                "id": "2",
                "permission": 3
            },
            {
                "id": "4",
                "permission": 3
            }
        ]
    },
    "id": 1
}

Odpowiedź:

{
    "jsonrpc": "2.0",
    "result": {
        "usrgrpids": [
            "17"
        ]
    },
    "id": 1
}

Zobacz także

Źródło

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