[comment]: # ({d229f871-d229f871})
# image.update

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

[comment]: # ({71734a46-71e9b7b3})
### Описание

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

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

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

[comment]: # ({/71734a46-71e9b7b3})

[comment]: # ({137e0fc6-b1c7183d})
### Параметры

`(object/array)` Свойства изображения, которые необходимо обновить.

Для каждого изображения должно быть определено свойство `imageid`, все остальные свойства необязательны.
Будут обновлены только переданные свойства, все остальные останутся без изменений.

Метод принимает изображения со [стандартными свойствами изображения](object#image).

[comment]: # ({/137e0fc6-b1c7183d})

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

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

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

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

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

[comment]: # ({3929ab3b-4aaa0fb1})
#### Переименовать изображение

Переименуйте изображение в "Cloud icon".

[Запрос](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "image.update",
    "params": {
        "imageid": "2",
        "name": "Cloud icon"
    },
    "id": 1
}
```

Ответ:

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

[comment]: # ({/3929ab3b-4aaa0fb1})

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

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

[comment]: # ({/5590c086-5590c086})