更新

描述

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

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

参数

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

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

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

参数类型描述
image字符串Base64编码图像。编码图像的最大大小为1 MB。可以通过更改ZBX_MAX_IMAGE_SIZE常量值来调整最大尺寸的大小。
支持的图像格式为:PNG,JPEG,GIF。

返回值

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

示例

重命名图像

将图像重命名为“Cloud icon”。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "image.update",
  4. "params": {
  5. "imageid": "2",
  6. "name": "Cloud icon"
  7. },
  8. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  9. "id": 1
  10. }

响应:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "imageids": [
  5. "2"
  6. ]
  7. },
  8. "id": 1
  9. }

来源

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