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 grupy użytkowników do aktualizacji.

Właściwość usrgrpid musi być zdefiniowana dla każdej grupy użytkowników, wszystkie pozostałe właściwości są opcjonalne. Zostaną zaktualizowane tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

Oprócz standardowych właściwości grupy użytkowników, metoda przyjmuje następujące parametry.

Parameter Type Description
hostgroup_rights object/array Uprawnienia grup hostów permissions, które zastąpią bieżące uprawnienia przypisane do grupy użytkowników.
templategroup_rights object/array Uprawnienia grup szablonów permissions, 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.
rights
(deprecated)		 object/array Ten parametr jest przestarzały, zamiast niego użyj hostgroup_rights lub templategroup_rights.
Uprawnienia do przypisania do grupy użytkowników.

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.