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

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

[comment]: # ({71e9b7b3-71e9b7b3})
### 描述

`object image.update(object/array images)`

此方法允许update现有图像。

::: noteclassic
此方法仅适用于*超级管理员*用户类型。
调用该方法的权限可在用户角色设置中撤销。有关更多信息，请参阅
[User
roles](/manual/web_interface/frontend_sections/administration/user_roles)

:::

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

[comment]: # ({999c7b33-b1c7183d})
### 参数

`(object/array)` 需要更新的图像属性.

每个图像必须定义`imageid`属性，其他所有属性均为可选。仅传递的属性会被更新，其余属性将保持不变.

除了[图像](object#图像)之外，该方法还接受以下参数.

| 参数 | [数据类型](/manual/api/reference_commentary#数据类型) | 描述 |
|--|--|------|
| image | string | Base64编码的图像。编码后图像的最大大小为1 MB。最大大小可通过修改ZBX\_MAX\_IMAGE\_SIZE常量值调整。<br>支持的图像格式包括: PNG, JPEG, GIF. |

[comment]: # ({/999c7b33-b1c7183d})

[comment]: # ({a4a768f8-a4a768f8})
### 返回值

`(object)` 返回一个包含更新图像ID的object，
这些ID存储在`imageids`属性下。

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

[comment]: # ({b41637d2-b41637d2})
### 示例

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

[comment]: # ({589d9913-4aaa0fb1})
#### 重命名图像

将图片重命名为"云图标".

请求:

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

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

[comment]: # ({/589d9913-4aaa0fb1})

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

CImage::update() 位于 *ui/include/classes/api/services/CImage.php* 文件中。

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