[comment]: # ({084d9051-084d9051})
# user.update

[comment]: # ({/084d9051-084d9051})

[comment]: # ({dbc24bad-dbc24bad})
### Opis

`object user.update(object/array users)`

Ta metoda pozwala na aktualizację istniejących użytkowników.

::: noteclassic
Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia 
do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz [Role
użytkownika](/manual/web_interface/frontend_sections/administration/user_roles)
aby uzyskać więcej informacji.
:::

::: noteclassic
Siła hasła użytkownika jest walidowana zgodnie z zasadami zdefiniowanymi 
w polityce hasła dostępnej w API uwierzytelniania. Zobacz [API 
uwierzytelniania](/manual/api/reference/authentication) aby uzyskać 
więcej informacji.
:::

[comment]: # ({/dbc24bad-dbc24bad})

[comment]: # ({8ed69eee-3b478f18})
### Parametry

`(object/array)` Właściwości użytkownika do zaktualizowania.

Właściwość `userid` musi być zdefiniowana dla każdego użytkownika, wszystkie inne
właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, wszystkie
inne pozostaną niezmienione.

Oprócz [standardowych właściwości użytkownika](object#użytkownik), metoda
akceptuje następujące parametry.

|Parametr|[Typ](/manual/api/reference_commentary#data_types)|Opis|
|--|--|------|
|passwd|string|Hasło użytkownika.<br><br>Może być pustym ciągiem znaków, jeśli użytkownik należy do grup lub jest przenoszony tylko do grup, które mają dostęp LDAP.|
|usrgrps|array|[Grupy użytkowników](/manual/api/reference/user/create), które zastąpią istniejące grupy użytkowników.<br><br>Grupy użytkowników muszą mieć zdefiniowaną właściwość `usrgrpid`.|
|medias|array| [Media użytkownika](/manual/api/reference/user/object#media), które zastąpią istniejące media.|
|user_medias<br>(przestarzałe)|array|Ten parametr jest przestarzały, zamiast tego użyj `medias`.<br>[Media użytkownika](/manual/api/reference/user/object#media), które zastąpią istniejące media.|

[comment]: # ({/8ed69eee-3b478f18})

[comment]: # ({4c3fb877-4c3fb877})
### Zwracane wartości

`(obiekt)` Zwraca obiekt zawierający identyfikatory zaktualizowanych użytkowników
we właściwości `userids`.

[comment]: # ({/4c3fb877-4c3fb877})

[comment]: # ({b41637d2-b41637d2})
### Przykłady

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({ca60eb4e-c0483e48})
#### Zmiana nazwy użytkownika

Zmień nazwę użytkownika na John Doe.

Zapytanie:

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

Odpowiedź:

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

[comment]: # ({/ca60eb4e-c0483e48})

[comment]: # ({2a24dd67-7ae4c491})
#### Zmiana roli użytkownika

Zmień rolę użytkownika.

Zapytanie:

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

Odpowiedź:

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

[comment]: # ({/2a24dd67-7ae4c491})

[comment]: # ({1083dc26-1083dc26})
### Zobacz także

-   [Autoryzacja](/manual/api/reference/authentication)

[comment]: # ({/1083dc26-1083dc26})

[comment]: # ({bbd5a07f-bbd5a07f})
### Źródło

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

[comment]: # ({/bbd5a07f-bbd5a07f})
