[comment]: # translation:outdated

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

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

[comment]: # ({b8844e81-821c3f80})
### Descripción

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

Este método permite actualizar mapas existentes.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos
pata llamar al método se pueden revocar en la configuración de roles de usuario. Ver [Roles de
usuario](/manual/web_interface/frontend_sections/users/user_roles)
para más información.
:::

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

[comment]: # ({c6a95b9f-7a706637})
### Parámetros

`(objeto/matriz)` Propiedades del mapa que se actualizarán.

La propiedad `mapid` debe definirse para cada mapa, todas las demás propiedades
son opcionales. Sólo se actualizarán las propiedades pasadas, todas las demás.
permanecerá sin cambios.

Además de las [propiedades de mapa estándar] (objeto#mapa), el método
Acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|links|array|[Map links](/manual/api/reference/map/object#map_link) para reemplazar los enlaces existentes.|
|selements|array|[Mapa de elementos](/manual/api/reference/map/object#map_element) para reemplazar los elementos existentes.|
|urls|array|[Asignar URL](/manual/api/reference/map/object#map_url) para reemplazar las URL existentes.|
|users|array|[Mapa usuario](/manual/api/reference/map/object#map_user) recursos compartidos para reemplazar los elementos existentes.|
|userGroups|array|[Asignar grupo de usuarios](/manual/api/reference/map/object#map_user_group) comparte para reemplazar los elementos existentes.|
|shapes|array|[Mapa de formas](/manual/api/reference/map/object#map_shapes) para reemplazar las formas existentes.|
|lines|array|[Líneas del mapa](/manual/api/reference/map/object#map_lines) para reemplazar las líneas existentes.|

::: nota
Para crear enlaces de mapas entre nuevos elementos del mapa necesitarás
para establecer el `selementid` de un elemento en un valor arbitrario y luego usar esto
valor para hacer referencia a este elemento en los enlaces `selementid1` o
Propiedades `selementid2`. Cuando se crea el elemento, este valor
ser reemplazado con la identificación correcta generada por Zabbix. [Ver ejemplo para
map.create.](create#create_a_host_map)
:::

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

[comment]: # ({f1256f7a-f1256f7a})
### Valores de retorno

`(objeto)` Devuelve un objeto que contiene los ID de los mapas actualizados
bajo la propiedad `sysmapids`.

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

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

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

[comment]: # ({b0f05028-6df0be65})
#### Cambiar el tamaño de un mapa

Cambie el tamaño del mapa a 1200x1200 píxeles.

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

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

Respuesta:

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

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

[comment]: # ({d4443aed-76eb7f1c})
#### Cambiar propietario del mapa

Disponible solo para administradores y superadministradores.

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

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

Respuesta:

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

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

[comment]: # ({6c6205f1-6c6205f1})
### Ver también

-   [Elemento del mapa](object#map_element)
-   [Enlace del mapa](object#map_link)
-   [URL del mapa](object#map_url)
-   [Usuario del mapa](object#map_user)
-   [Grupo de usuarios del mapa](object#map_user_group)
-   [Formas del mapa](object#map_shapes)
-   [Líneas del mapa](object#map_lines)

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

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

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

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