# usergroup.create

### Описание

`объект usergroup.create(объект/массив ГруппыПользователей)`

Этот метод позволяет создавать новые группы пользователей.

### Параметры

`(объект/массив)` Создаваемые группы пользователей.

В дополнение к [стандартным свойствам группы
пользователей](object#группа_пользователей), этот метод принимает
следующие параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|rights|объект/массив|Назначаемые права доступа на группу.|
|userids|строка/массив|ID добавляемых пользователей в группу пользователей.|

### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID созданных групп
пользователей под свойством `usrgrpids`. Порядок возвращаемых ID
совпадает с порядком переданных групп пользователей.

### Примеры

#### Создание групп пользователей

Создание группы пользователей, которая запрещает доступ к группе узлов
сети "2", и добавляет к себе пользователя.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "usergroup.create",
    "params": {
        "name": "Operation managers",
        "rights": {
            "permission": 0,
            "id": "2"
        },
        "userids": "12"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

### Смотрите также

-   [Права доступа](object#права_доступа)

### Исходный код

CUserGroup::create() в *frontends/php/api/classes/CUserGroup.php*.