[comment]: # translation:outdated

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

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

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

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

Mit dieser Methode können vorhandene Karten aktualisiert werden.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen
zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [User
roles](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu aktualisierende Karteneigenschaften.

Die Eigenschaft `mapid` muss für jede Karte definiert werden, alle anderen Eigenschaften
sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen
bleiben unverändert.

Zusätzlich zu den [standardmäßigen Karteneigenschaften](object#map) akzeptiert die Methode
die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|links|array|[Kartenverknüpfungen](/manual/api/reference/map/object#map-link), die die vorhandenen Verknüpfungen ersetzen.|
|selements|array|[Kartenelemente](/manual/api/reference/map/object#map-element), die die vorhandenen Elemente ersetzen.|
|urls|array|[Karten-URLs](/manual/api/reference/map/object#map-url), die die vorhandenen URLs ersetzen.|
|users|array|[Kartenbenutzer-](/manual/api/reference/map/object#map-user)Freigaben, die die vorhandenen Elemente ersetzen.|
|userGroups|array|[Freigaben für Karten-Benutzergruppen](/manual/api/reference/map/object#map-user-group), die die vorhandenen Elemente ersetzen.|
|shapes|array|[Kartenformen](/manual/api/reference/map/object#map-shapes), die die vorhandenen Formen ersetzen.|
|lines|array|[Kartenlinien](/manual/api/reference/map/object#map-lines), die die vorhandenen Linien ersetzen.|

::: notetip
Um Kartenverknüpfungen zwischen neuen Kartenelementen zu erstellen, müssen Sie
die `selementid` eines Elements auf einen beliebigen Wert setzen und dann diesen
Wert verwenden, um in den Eigenschaften `selementid1` oder
`selementid2` der Verknüpfungen auf dieses Element zu verweisen. Wenn das
Element erstellt wird, wird dieser Wert durch die korrekte von Zabbix generierte ID ersetzt. [Siehe Beispiel für
map.create.](create#create-a-host-map)
:::

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

[comment]: # ({f1256f7a-f1256f7a})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten Maps
unter der Eigenschaft `sysmapids` enthält.

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

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

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

[comment]: # ({b0f05028-6df0be65})
#### Größe einer Karte ändern

Ändern Sie die Größe der Karte auf 1200x1200 Pixel.

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

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

Antwort:

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

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

[comment]: # ({d4443aed-76eb7f1c})
#### Eigentümer der Karte ändern

Nur für Admins und Super-Admins verfügbar.

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

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

Antwort:

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

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

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

-   [Kartenelement](object#map-element)
-   [Kartenverknüpfung](object#map-link)
-   [Karten-URL](object#map-url)
-   [Kartenbenutzer](object#map-user)
-   [Kartenbenutzergruppe](object#map-user-group)
-   [Kartenformen](object#map-shapes)
-   [Kartenlinien](object#map-lines)

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

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

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

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