map.update

Descripción

object map.update(object/array maps)

Este método permite actualizar mapas existentes.

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 para más información.

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án sin cambios.

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

Parámetro Tipo Descripción
links matriz Enlaces de mapa para reemplazar los enlaces existentes.
selements matriz Elementos asignados para reemplazar los elementos existentes.
urls matriz URL asignadas para reemplazar las URL existentes.
users matriz Usuario para compartir el mapa asignados para reemplazar los elementos existentes.
userGroups matriz Grupos de usuarios para compartir el mapa asignados para reemplazar los elementos existentes.
shapes matriz Formas asignadas para reemplazar las formas existentes.
lines matriz Líneas asignadas para reemplazar las líneas existentes.

Para crear enlaces de mapas entre nuevos elementos del mapa necesitarás establecer el selementid de un elemento en un valor arbitrario y luego usar este valor para hacer referencia a este elemento en los enlaces selementid1 o propiedades selementid2. Cuando se crea el elemento, este valor es reemplazado con la identificación correcta generada por Zabbix. Ver ejemplo para map.create.

Valores de retorno

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

Ejemplos

Cambiar el tamaño de un mapa

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

Solicitud:

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

Respuesta:

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

Cambiar propietario del mapa

Disponible solo para administradores y superadministradores.

Solicitud:

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

Respuesta:

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

Ver también

Fuente

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