[comment]: # ({df556223-df556223})
# map.update

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

[comment]: # ({d4aa5239-77378e6b})
### Description

`object map.update(object/array maps)`

Cette méthode permet de mettre à jour les cartes existantes.

[comment]: # ({/d4aa5239-77378e6b})

[comment]: # ({d5e4a841-0fb33619})
### Paramètres

`(object/array)` Propriétés de carte à mettre à jour.

La propriété `mapid` doit être définie pour chaque carte, 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 carte
standard](/fr/manual/api/reference/map/object#carte), la méthode accepte
les paramètres suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|links|array|Liens de carte en remplacement des liens existants.|
|selements|array|Eléments de carte en remplacement des éléments existants.|
|urls|array|URL de carte en remplacement des URL existantes.|
|users|array|Partages utilisateurs en remplacement des partages existants.|
|userGroups|array|Partages groupes utilisateurs en remplacement des partages existants.|
|shapes|array|Formes de carte en remplacement des formes existantes.|
|lines|array|Lignes de carte en remplacement des lignes existants.|

::: notetip
Pour créer des liens de carte, il est nécessaire de
définir un élément de carte `selementid` sur une valeur arbitraire, puis
d'utiliser cette valeur pour référencer cet élément dans les propriétés
des liens `selementid1` ou `selementid2`. Lors de la création de
l'élément, cette valeur sera remplacée par l'ID correct généré par
Zabbix. [Voir
l'exemple](/fr/manual/api/reference/map/create#creer_une_carte_d_hote).
:::

[comment]: # ({/d5e4a841-0fb33619})

[comment]: # ({05f92c4b-f1256f7a})
### Valeurs retournées

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

[comment]: # ({/05f92c4b-f1256f7a})

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

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

[comment]: # ({0c1b6869-6df0be65})
#### Redimensionnement d'une carte

Changer la taille de la carte en 1200x1200 pixels.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "map.update",
    "params": {
        "sysmapid": "8",
        "width": 1200,
        "height": 1200
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "8"
        ]
    },
    "id": 1
}
```

[comment]: # ({/0c1b6869-6df0be65})

[comment]: # ({e486c04f-76eb7f1c})
#### Changement du propriétaire de la carte

Disponible uniquement pour les administrateurs et les super
administrateurs.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "map.update",
    "params": {
        "sysmapid": "9",
        "userid": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "9"
        ]
    },
    "id": 2
}
```

[comment]: # ({/e486c04f-76eb7f1c})

[comment]: # ({111fc5b7-6c6205f1})
### Voir également

-   [Elément de
    carte](/fr/manual/api/reference/map/object#element_de_carte)
-   [Lien de carte](/fr/manual/api/reference/map/object#lien_de_carte)
-   [URL de carte](/fr/manual/api/reference/map/object#url_de_carte)
-   [Utilisateur de
    carte](/fr/manual/api/reference/map/object#utilisateur_de_carte)
-   [Groupe d'utilisateurs de
    carte](/fr/manual/api/reference/map/object#groupe_d_utilisateurs_de_carte)
-   [Forme de carte](/fr/manual/api/reference/map/object#forme_de_carte)
-   [Ligne de carte](/fr/manual/api/reference/map/object#ligne_de_carte)

[comment]: # ({/111fc5b7-6c6205f1})

[comment]: # ({ccd35a4f-63c22583})
### Source

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

[comment]: # ({/ccd35a4f-63c22583})