Áú»¢¶Ä²©

user.update

¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®

object user.update(object/array users)

Aquest m¨¨tode permet actualitzar usuaris.

Aquest m¨¨tode ¨¦s disponible per als usuaris de qualsevol tipus. Els permisos per cridar al m¨¨tode es poden revocar a la configuraci¨® de rols d'usuaris. Per a m¨¦s informaci¨®, veieu Rols d'usuari.

La fortalesa del mot de pas de l'usuari es valida d'acord amb les regles de la pol¨ªtica de mots de pas definida per l'API d'autenticaci¨®. Veieu API d'autenticaci¨® per obtindre m¨¦s informaci¨®.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ

(object/array) Les propietats d'usuari que s'han d'actualitzar.

La propietat userid s'ha de definir per a cada usuari, totes les altres propietats s¨®n opcionals. Nom¨¦s s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A m¨¦s de les propietats d'usuari est¨¤ndard, el m¨¨tode admet els par¨¤metres seg¨¹ents.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð Tipus ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
current_passwd string Mot de pas actual de l'usuari.

El valor d'aquest par¨¤metre pot ser una cadena buida si l'usuari ¨¦s vinculat a un directori d'usuari.

Comportament del par¨¤metre:
- nom¨¦s escriptura
- obligatori si passwd de l'objecte d'usuari ¨¦s establert i l'usuari canvia el seu mot de pas
usrgrps array Grups d'usuaris per substituir els grups d'usuaris existents.

Els grups d'usuaris han de tindre la propietat usrgrpid definida.
medias array Suports d'usuari per substituir els suports existents i no provisionats. Els suports provisionats es poden ometre quan s'actualitzi el suport.

Valors de retorn

(object) Torna un objecte que contingui els IDs dels usuaris actualitzats sota la propietat userids.

Exemples

Reanomenar un usuari

Reanomena un usuari a "Josep Perarnau".

±Ê±ð³Ù¾±³¦¾±¨®:

{
           "jsonrpc": "2.0",
           "method": "user.update",
           "params": {
               "userid": "1",
               "name": "Josep",
               "surname": "Perarnau"
           },
           "id": 1
       }

Resposta:

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

Canviar el rol d'usuari

Canvia el rol d'un usuari.

±Ê±ð³Ù¾±³¦¾±¨®:

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

Resposta:

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

Veieu tamb¨¦

Font

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