[comment]: # translation:outdated

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

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

[comment]: # ({131691fb-dbc24bad})
### Описание

`object user.update(объект/массив users)`

Этот метод позволяет обновлять существующих пользователей.

::: noteclassic
Этот метод доступен пользователям любого типа.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

::: noteclassic
Сложность пароля пользователя проверяется в соответствии с правилами политики паролей, определенными API аутентификации. Подробнее см. в [API аутентификации](/manual/api/reference/authentication).
:::

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

[comment]: # ({new-3b478f18})
### Параметры

`(объект/массив)` Свойства пользователей, которые будут обновлены.

Свойство `userid` должно быть указано по каждому пользователю, все
остальные свойства опциональны. Будут обновлены только переданные
свойства, все остальные останутся неизменными.

В дополнение к [стандартным свойствам
пользователя](object#пользователь), этот метод принимает следующие
параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|passwd|строка|Пароль пользователя.|
|usrgrps|массив|Группы пользователей, которые заменят существующие группы пользователей.<br><br>У групп пользователей должно быть задано свойство `usrgrpid`.|
|user\_medias|массив|Оповещения, которые заменят текущие оповещения пользователя.|

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

[comment]: # ({4c3fb877-4c3fb877})
### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID обновленных
пользователей, указанных в свойстве`userids`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({80c14ff1-c0483e48})
#### Переименование пользователя

Переименовать пользователя в John Doe.

Запрос:

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

Ответ:

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

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

[comment]: # ({cad54c9a-7ae4c491})
#### Изменение роли пользователя

Изменить роль пользователя.

Запрос:

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

Ответ:

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

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

[comment]: # ({1083dc26-1083dc26})
### Смотрите также

-   [Аутентификация](/manual/api/reference/authentication)

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

[comment]: # ({bbd5a07f-bbd5a07f})
### Источник

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

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