This is a translation of the original English documentation page. Help us make it better.

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.

Parameter Type Description
image string Base64 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.

Valori di ritorno

(object) Restituisce un oggetto contenente gli ID delle immagini aggiornate sotto la proprietà imageids.

Esempi

Rename image

Rename image to "Cloud icon".

Request:

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

Response:

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

Fonte

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