Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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 Super admin. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para más información.

Parámetros

(objeto/array) Grupos de usuarios a crear.

Además de las propiedades estándar del grupo de usuarios, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
hostgroup_rights objeto/array Permisos de grupo de equipos para asignar al grupo de usuarios.
templategroup_rights objeto/array Permisos de grupo de plantillas para asignar al grupo de usuarios.
tag_filters array Permisos basados en etiquetas para asignar al grupo de usuarios.
users objeto/array Usuarios para añadir al grupo de usuarios.

El usuario debe tener definida únicamente la propiedad userid.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los grupos de usuarios creados bajo la propiedad usrgrpids. El orden de los IDs devueltos coincide con el orden de los grupos de usuarios pasados.

Ejemplos

Creando un grupo de usuarios

Cree un grupo de usuarios Operation managers con acceso denegado al grupo de equipos "2" y añada un usuario al mismo.

Solicitud:

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

Respuesta:

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

Véase también

Fuente

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