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

(object/array) 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 estándar del mapa, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
links array Enlaces de mapa para reemplazar los enlaces existentes.
selements array Elementos de mapa para reemplazar los elementos existentes.
urls array URLs de mapa para reemplazar las URLs existentes.
users array Usuarios de mapa para reemplazar los elementos existentes.
userGroups array Grupos de usuarios de mapa para reemplazar los elementos existentes.
shapes array Formas de mapa para reemplazar las formas existentes.
lines array Líneas de mapa para reemplazar las líneas existentes.

Para crear enlaces de mapa entre nuevos elementos de mapa, deberá establecer el selementid de un elemento en un valor arbitrario y luego utilizar este valor para hacer referencia a este elemento en las propiedades selementid1 o selementid2 de los enlaces. Cuando se cree el elemento, este valor se sustituirá por el ID correcto generado por Zabbix. Consulte el ejemplo de 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.