usergroup.create

Descripción

object usergroup.create(object/array userGroups)

Este método permite crear nuevos grupos de usuarios.

Este método solo está disponible para el tipo de usuario Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver Roles de usuario para obtener más información.

Parameters

(object/array) User groups to create.

Additionally to the standard user group properties, the method accepts the following parameters.

Parameter	Type	Description
rights	object/array	Permissions to assign to the group
tag_filters	array	Tag based permissions to assign to the group
users	object/array	Users to add to the user group. The user must have the `userid` property defined.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los grupos de usuarios creados bajo la propiedad usrgrpids. El orden de las identificaciones devueltas. coincide con el orden de los grupos de usuarios pasados.

Ejemplos

Creating a user group

Create a user group, which denies access to host group "2", and add a user to it.

Request:

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

Response:

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

Ver también

Permiso

Fuente

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

Documentation