[comment]: # ({d229f871-d229f871})
# image.update

[comment]: # ({/d229f871-d229f871})

[comment]: # ({f5a0d2a4-ec55c3bb})
### Description

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

Cette méthode permet de mettre à jour des images existantes.

[comment]: # ({/f5a0d2a4-ec55c3bb})

[comment]: # ({1e226c25-d3fa67fb})
### Paramètres

`(object/array)` Propriétés de l'image à mettre à jour.

La propriété `imageid` doit être définie pour chaque image, toutes les
autres propriétés sont facultatives. Seules les propriétés transmises
seront mises à jour, toutes les autres resteront inchangées.

En plus des [propriétés de l'objet image
standard](/fr/manual/api/reference/image/object#image), la méthode
accepte les paramètres suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|image|string|Image encodée en base64. La taille maximale de l'image encodée est de 1 Mo.|

[comment]: # ({/1e226c25-d3fa67fb})

[comment]: # ({1414fafa-a4a768f8})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des images mises
à jour sous la propriété `imageids`.

[comment]: # ({/1414fafa-a4a768f8})

[comment]: # ({88e43968-b41637d2})
### Exemples

[comment]: # ({/88e43968-b41637d2})

[comment]: # ({ae683f5d-4aaa0fb1})
#### Renommage d'une image

Renommer une image en "Cloud icon".

Requête :

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

Réponse :

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

[comment]: # ({/ae683f5d-4aaa0fb1})

[comment]: # ({f07e2ad8-86bc2155})
### Source

CImage::update() dans
*frontends/php/include/classes/api/services/CImage.php*.

[comment]: # ({/f07e2ad8-86bc2155})