map.update

Descrição

object map.update(object/array maps)

Este método permite atualizar mapas existentes.

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 para mais informações.

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, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
links array Links do mapa para substituir os links existentes.
selements array Elementos do mapa para substituir os elementos existentes.
urls array URLs do mapa para substituir as URLs existentes.
users array Compartilhamentos de usuário do mapa para substituir os elementos existentes.
userGroups array Compartilhamentos de grupo de usuários do mapa para substituir os elementos existentes.
shapes array Formas do mapa para substituir as formas existentes.
lines array Linhas do mapa para substituir as linhas existentes.

Para criar links de mapa entre novos elementos do mapa, você precisará definir o selementid de um elemento para um valor arbitrário e então 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.

Valores de retorno

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

Exemplos

Redimensionar um mapa

Altere o tamanho do mapa para 1200x1200 pixels.

Requisição:

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

Resposta:

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

Alterar proprietário do mapa

Disponível apenas para administradores e super administradores.

Requisição:

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

Resposta:

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

Veja também

Fonte

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