Esta es una traducción de la página de documentación original en español. Ayúdanos a mejorarla.

user.update

Descripción

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.

Parameters

(object/array) User properties to be updated.

The userid property must be defined for each user, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.

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

Parameter Type Description
passwd string User's password.

Can be empty string if user belongs to or is moved only to groups that have LDAP access.
usrgrps array User groups to replace existing user groups.

The user groups must have the usrgrpid property defined.
medias array User media to replace existing media.

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.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "user.update",
           "params": {
               "userid": "1",
               "name": "John",
               "surname": "Doe"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

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

Cambiar rol de usuario

Cambiar el rol de un usuario.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "user.update",
           "params": {
               "userid": "12",
               "roleid": "6"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "userids": [
                   "12"
               ]
           },
           "id": 1
       }

See also

Fuente

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