更新

描述

object image.update(object/array images)

该方法允许对已存在的图片进行更新。

参数

(object/array) 要更新的图像属性。

必须为每个图像定义imageid属性，所有其他属性都是可选的。只有通过的属性将被更新，所有其他属性将保持不变。

除了标准图像属性值外，该方法接受以下参数：

参数 [ 型](/zh/manual/api/reference_commentary#data_types) 描述
image 字符串 Ba e64编码图像。编码图像的最大大小为1 MB。可以通过更改ZBX_MAX_IMAGE_SIZE常量值来调整最大尺寸的大小。
支持的图像格式为：PNG，JPEG，GIF。

返回值

(object) 在imageids属性中返回已更新图像ID的对象。

示例

重命名图像

将图像重命名为"Cloud icon"。

请求:

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

响应:

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

来源

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