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 akceptuje następujące parametry.

Parametr Typ Opis
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ą wyłącznie 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 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.