[comment]: # translation:outdated

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

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

[comment]: # ({b8844e81-821c3f80})
### Descrizione

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

Questo metodo consente di aggiornare mappe esistenti.

::: noteclassic
Questo metodo è disponibile per utenti di qualsiasi tipo. Le autorizzazioni
per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente. Vedere [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
per ulteriori informazioni.
:::

[comment]: # ({/b8844e81-821c3f80})

[comment]: # ({a3b4ed68-7a706637})
### Parametri

`(object/array)` Proprietà della mappa da aggiornare.

La proprietà `mapid` deve essere definita per ogni mappa, tutte le altre proprietà
sono facoltative. Verranno aggiornate solo le proprietà passate, tutte le altre
rimarranno invariate.

Oltre alle [proprietà standard della mappa](object#map), il metodo
accetta i seguenti parametri.

|Parametro|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|links|array|[Collegamenti della mappa](/manual/api/reference/map/object#map-link) per sostituire i collegamenti esistenti.|
|selements|array|[Elementi della mappa](/manual/api/reference/map/object#map-element) per sostituire gli elementi esistenti.|
|urls|array|[URL della mappa](/manual/api/reference/map/object#map-url) per sostituire gli URL esistenti.|
|users|array|[Condivisioni utente della mappa](/manual/api/reference/map/object#map-user) per sostituire gli elementi esistenti.|
|userGroups|array|[Condivisioni gruppo utenti della mappa](/manual/api/reference/map/object#map-user-group) per sostituire gli elementi esistenti.|
|shapes|array|[Forme della mappa](/manual/api/reference/map/object#map-shapes) per sostituire le forme esistenti.|
|lines|array|[Linee della mappa](/manual/api/reference/map/object#map-lines) per sostituire le linee esistenti.|

::: notetip
Per creare collegamenti della mappa tra nuovi elementi della mappa, sarà necessario
impostare `selementid` di un elemento su un valore arbitrario e poi usare questo
valore per fare riferimento a questo elemento nelle proprietà `selementid1` o
`selementid2` dei collegamenti. Quando l'elemento viene creato, questo valore verrà
sostituito con l'ID corretto generato da Zabbix. [Vedere l'esempio per
map.create.](create#create-a-host-map)
:::

[comment]: # ({/a3b4ed68-7a706637})

[comment]: # ({f1256f7a-f1256f7a})
### Restituisce i valori

`(oggetto)` Restituisce un oggetto contenente gli ID delle mappe aggiornate
sotto la proprietà `sysmapids`.

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

[comment]: # ({b41637d2-b41637d2})
### Esempi

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

[comment]: # ({b0f05028-6df0be65})
#### Ridimensionare una mappa

Modificare la dimensione della mappa a 1200x1200 pixel.

[Richiesta](/manual/api#performing-requests):

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

Risposta:

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

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

[comment]: # ({d4443aed-76eb7f1c})
#### Cambiare il proprietario della mappa

Disponibile solo per admin e super admin.

[Richiesta](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "map.update",
    "params": {
        "sysmapid": "9",
        "userid": "1"
    },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "sysmapids": [
            "9"
        ]
    },
    "id": 1
}
```

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

[comment]: # ({7694e802-6c6205f1})
### Vedi anche

-   [Elemento della mappa](object#map-element)
-   [Collegamento della mappa](object#map-link)
-   [URL della mappa](object#map-url)
-   [Utente della mappa](object#map-user)
-   [Gruppo utenti della mappa](object#map-user-group)
-   [Forme della mappa](object#map-shapes)
-   [Linee della mappa](object#map-lines)

[comment]: # ({/7694e802-6c6205f1})

[comment]: # ({2f149f32-2f149f32})
### Fonte

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

[comment]: # ({/2f149f32-2f149f32})