usergroup.create

Opis

object usergroup.create(object/array userGroups)

Ta metoda pozwala na tworzenie nowych grup użytkowników.

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) Grupy użytkowników do utworzenia.

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

Parametr	Typ	Opis
rights	object/array	Uprawnienia przypisane do grupy
tag_filters	array	Uprawnienia oparte na znacznikach przypisane do grupy
users	object/array	Użytkownicy do dodania do grupy użytkowników. Użytkownik musi mieć zdefiniowaną właściwość `userid`.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych grup użytkowników we właściwości usrgrpids. Kolejność zwróconych identyfikatorów odpowiada kolejności przekazanych grup użytkowników.

Przykłady

Tworzenie grupy użytkowników

Utwórz grupę użytkowników, która odmawia dostępu do grupy hostów "2", i dodaj do niej użytkownika.

Zapytanie:

{
           "jsonrpc": "2.0",
           "method": "usergroup.create",
           "params": {
               "name": "Operation managers",
               "rights": {
                   "permission": 0,
                   "id": "2"
               },
               "users": [
                   {"userid": "12"}
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Odpowiedź:

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

Zobacz także

Uprawnienia

Źródło

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

Documentation