user.update

Apraksts

object user.update(object/array users)

Šī metode ļauj atjaunināt esošos lietotājus.

Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Lietotāja paroles stiprums tiek validēts saskaņā ar paroles politikas noteikumiem, ko definē Authentication API. Plašāku informāciju skatiet Authentication API.

Parametri

(object/array) Atjaunināmie lietotāja rekvizīti.

Katram lietotājam ir jābūt norādītam rekvizītam userid, visi pārējie rekvizīti nav obligāti. Tiks atjaunināti tikai nodotie rekvizīti, visi pārējie paliks nemainīti.

Papildus standarta lietotāja rekvizītiem metode pieņem šādus parametrus.

Parametrs Tips Apraksts
current_passwd string Lietotāja pašreizējā parole.

Šī parametra vērtība var būt tukša virkne, ja lietotājs ir saistīts ar lietotāju direktoriju.

Parametra darbība:
- tikai rakstīšanai
- obligāts, ja User object rekvizīts passwd ir iestatīts un lietotājs maina savu paroli
usrgrps array Lietotāju grupas, ar kurām aizstāt esošās lietotāju grupas.

Lietotāju grupām jābūt definētam tikai rekvizītam usrgrpid.
medias array Lietotāja datu nesēji, ar kuriem aizstāt esošos, neprovisionētos datu nesējus. Provisionētie datu nesēji var tikt izlaisti, atjauninot datu nesējus.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur atjaunināto lietotāju ID īpašībā userids.

Piemēri

Lietotāja pārdēvēšana

Pārdēvējiet lietotāju par John Doe.

Pieprasījums:

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

Atbilde:

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

Lietotāja lomas maiņa

Mainiet lietotāja lomu.

Pieprasījums:

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

Atbilde:

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

Skatiet arī

Avots

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