user.update

Apraksts

object user.update(object/array users)

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

Šī metode ir pieejama visu veidu lietotājiem. Atļauju izsaukt šo metodi var atsaukt lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Lietotāja paroles stiprums tiek pārbaudīts atbilstoši paroles politikas noteikumiem, kas definēti Authentication API. Plašāku informāciju skatiet sadaļā 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.