usergroup.create

Opis

object usergroup.create(object/array userGroups)

Ta metoda umożliwia tworzenie nowych grup użytkowników.

Ta metoda jest dostępna tylko dla użytkowników typu 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) Grupy użytkowników do utworzenia.

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 do przypisania do grupy użytkowników.
templategroup_rights object/array Uprawnienia grup szablonów do przypisania do grupy użytkowników.
tag_filters array Uprawnienia oparte na tagach do przypisania do grupy użytkowników.
users object/array Użytkownicy do dodania do grupy użytkowników.

Użytkownik musi mieć zdefiniowaną tylko właściwość userid.
rights
(deprecated)		 object/array Ten parametr jest przestarzały, proszę zamiast niego użyć hostgroup_rights lub templategroup_rights.
Uprawnienia do przypisania do grupy użytkowników.

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 Operation managers z zabronionym dostępem do grupy hostów „2” i dodaj do niej użytkownika.

Request:

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

Odpowiedź:

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

Zobacz także

Źródło

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