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.update

Descripción

object usergroup.update(object/array userGroups)

Este método permite actualizar grupos de usuarios existentes.

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) Propiedades del grupo de usuarios que se actualizarán.

La propiedad usrgrpid debe estar definida para cada grupo de usuarios, todas las demás propiedades son opcionales. Solo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

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 reemplazar los permisos actuales asignados al grupo de usuarios.
templategroup_rights objeto/array Permisos de grupo de plantillas para reemplazar los permisos actuales asignados al grupo de usuarios.
tag_filters array Permisos basados en etiquetas para reemplazar los permisos actuales asignados al grupo de usuarios.
users objeto/array Usuarios para reemplazar los usuarios actuales asignados al grupo de usuarios.

El usuario debe tener definida solo la propiedad userid.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los grupos de usuarios actualizados bajo la propiedad usrgrpids.

Ejemplos

Habilitar un grupo de usuarios y actualizar permisos

Habilite un grupo de usuarios y proporcione acceso de lectura-escritura para él a los grupos de equipos "2" y "4".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "usergroup.update",
           "params": {
               "usrgrpid": "17",
               "users_status": "0",
               "hostgroup_rights": [
                   {
                       "id": "2",
                       "permission": 3
                   },
                   {
                       "id": "4",
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Véase también

Fuente

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