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

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

[comment]: # ({b8844e81-821c3f80})
### Descrição

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

Este método permite atualizar mapas existentes.

::: noteclassic
Este método está disponível para usuários de qualquer tipo. As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Veja [Funções de usuário](/manual/web_interface/frontend_sections/users/user_roles) para mais informações.
:::

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

[comment]: # ({a3b4ed68-7a706637})
### Parâmetros

`(object/array)` Propriedades do mapa a serem atualizadas.

A propriedade `mapid` deve ser definida para cada mapa, todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das [propriedades padrão do mapa](object#map), o método aceita os seguintes parâmetros.

|Parâmetro|[Tipo](/manual/api/reference_commentary#data-types)|Descrição|
|--|--|------|
|links|array|[Links do mapa](/manual/api/reference/map/object#map-link) para substituir os links existentes.|
|selements|array|[Elementos do mapa](/manual/api/reference/map/object#map-element) para substituir os elementos existentes.|
|urls|array|[URLs do mapa](/manual/api/reference/map/object#map-url) para substituir as URLs existentes.|
|users|array|[Compartilhamentos de usuário do mapa](/manual/api/reference/map/object#map-user) para substituir os elementos existentes.|
|userGroups|array|[Compartilhamentos de grupo de usuários do mapa](/manual/api/reference/map/object#map-user-group) para substituir os elementos existentes.|
|shapes|array|[Formas do mapa](/manual/api/reference/map/object#map-shapes) para substituir as formas existentes.|
|lines|array|[Linhas do mapa](/manual/api/reference/map/object#map-lines) para substituir as linhas existentes.|

::: notetip
Para criar links de mapa entre novos elementos do mapa, você precisará definir o `selementid` de um elemento para um valor arbitrário e, em seguida, usar esse valor para referenciar esse elemento nas propriedades `selementid1` ou `selementid2` dos links. Quando o elemento for criado, esse valor será substituído pelo ID correto gerado pelo Zabbix. [Veja o exemplo para map.create.](create#create-a-host-map)
:::

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

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

`(object)` Retorna um objeto contendo os IDs dos mapas atualizados
na propriedade `sysmapids`.

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

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

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

[comment]: # ({b0f05028-6df0be65})
#### Redimensionar um mapa

Altere o tamanho do mapa para 1200x1200 pixels.

[Requisição](/manual/api#performing-requests):

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

Resposta:

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

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

[comment]: # ({d4443aed-76eb7f1c})
#### Alterar proprietário do mapa

Disponível apenas para administradores e super administradores.

[Requisição](/manual/api#performing-requests):

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

Resposta:

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

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

[comment]: # ({7694e802-6c6205f1})
### Veja também

-   [Elemento de mapa](object#map-element)
-   [Link de mapa](object#map-link)
-   [URL de mapa](object#map-url)
-   [Usuário de mapa](object#map-user)
-   [Grupo de usuários de mapa](object#map-user-group)
-   [Formas de mapa](object#map-shapes)
-   [Linhas de mapa](object#map-lines)

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

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

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

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