这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

更新

描述

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.