Documentation
Table of Contents
user.update
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
object user.update(object/array users)
Este m¨¦todo permite actualizar los usuarios existentes.
Este m¨¦todo est¨¢ disponible para usuarios de cualquier tipo. 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.
La seguridad de la contrase?a del usuario se valida de acuerdo con las reglas de pol¨ªtica de contrase?as definidas por la API de autenticaci¨®n. Consulte API de autenticaci¨®n para obtener m¨¢s informaci¨®n.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(objeto/matriz) Propiedades del usuario que se actualizar¨¢n.
La propiedad userid debe definirse para cada usuario, todos los dem¨¢s Las propiedades son opcionales. S¨®lo se actualizar¨¢n las propiedades pasadas, todas otros permanecer¨¢n sin cambios.
Adem¨¢s de las [propiedades de usuario est¨¢ndar] (objeto#usuario), el m¨¦todo Acepta los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| current_passwd | string | Contrase?a actual del usuario. El valor de este par¨¢metro puede ser una cadena vac¨ªa si el usuario est¨¢ vinculado a un directorio de usuarios.< br> Comportamiento de par¨¢metros: - solo escritura - obligatorio si contrase?a de objeto de usuario est¨¢ configurado y el usuario cambia su propia contrase?a de usuario |
| usrgrps | array | Grupos de usuarios para reemplazar los grupos de usuarios existentes. Los grupos de usuarios deben tener solo la propiedad usrgrpid definida. |
| medias | array | User media para reemplazar los medios existentes no aprovisionados. Los medios proporcionados se pueden omitir al actualizar los medios. |
Valores de retorno
(objeto) Devuelve un objeto que contiene los ID de los usuarios actualizados bajo la propiedad userids.
Ejemplos
Cambiar el nombre de un usuario
Cambie el nombre de un usuario a John Doe.
{
"jsonrpc": "2.0",
"method": "user.update",
"params": {
"userid": "1",
"name": "John",
"surname": "Doe"
},
"id": 1
}Respuesta:
Cambiar rol de usuario
Cambiar el rol de un usuario.
Respuesta:
See also
Fuente
CUser::update() en ui/include/classes/api/services/CUser.php.