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 para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte 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. Solo 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 del mapa para reemplazar los enlaces existentes.
selements array Elementos del mapa para reemplazar los elementos existentes.
urls array URLs del mapa para reemplazar las URLs existentes.
users array Usuarios del mapa para reemplazar los elementos existentes.
userGroups array Grupos de usuarios del mapa para reemplazar los elementos existentes.
shapes array Formas del mapa para reemplazar las formas existentes.
lines array Líneas del mapa para reemplazar las líneas existentes.

Para crear enlaces de mapa entre nuevos elementos del mapa, deberá establecer el selementid de un elemento en un valor arbitrario y luego usar 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 reemplazará por el ID correcto generado por Zabbix. Consulte el ejemplo para map.create.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs 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.