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
(object/array) Propiedades del grupo de usuarios que se van a actualizar.
La propiedad usrgrpid debe estar definida para cada grupo de usuarios; todas las demás
propiedades son opcionales. Solo se actualizarán las propiedades enviadas; 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.
| Parameter | Type | Description |
|---|---|---|
| hostgroup_rights | object/array | Permisos de grupo de hosts que reemplazarán los permisos actuales asignados al grupo de usuarios. |
| templategroup_rights | object/array | Permisos de grupo de templates que reemplazarán los permisos actuales asignados al grupo de usuarios. |
| tag_filters | array | Permisos basados en etiquetas que reemplazarán los permisos actuales asignados al grupo de usuarios. |
| users | object/array | Usuarios que reemplazarán a los usuarios actuales asignados al grupo de usuarios. El usuario debe tener definida solo la propiedad userid. |
| rights (deprecated) |
object/array | Este parámetro está obsoleto; use hostgroup_rights o templategroup_rights en su lugar.Permisos que se asignarán al grupo de usuarios. |
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".
{
"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.