image.update

Description

object image.update(object/array images)

This method allows to update existing images.

This method is only available to Super admin user type. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object/array) Image properties to be updated.

The imageid property must be defined for each image, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.

Additionally to the standard image properties, the method accepts the following parameters.

ParameterTypeDescription
imagestringBase64 encoded image. The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing ZBX_MAX_IMAGE_SIZE constant value.
Supported image formats are: PNG, JPEG, GIF.

Return values

(object) Returns an object containing the IDs of the updated images under the imageids property.

Examples

Rename image

Rename image to “Cloud icon”.

Request:

  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.        }

Response:

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

Source

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