map.create

Descripción

object map.create(object/array maps)

Este método permite crear nuevos mapas.

Este método está disponible para usuarios de cualquier tipo. Los permisos para activar el método se pueden revocar en la configuración de roles de usuario. Ver User roles para más información.

Parámetros

(objeto/matriz) Maps to create.

Además de las standard map properties, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
links matriz Mapa links que se creará en el mapa.
selements matriz Mapa elements que se creará en el mapa.
urls matriz Mapa URL que se creará en el mapa.
users array Map user shares to be created on the map.
userGroups matriz Mapa user group recursos compartidos que se crearán en el mapa.
shapes matriz Mapa shapes que se creará en el mapa.
lines matriz Mapa lines que se creará en el mapa.

Para crear enlaces de mapas, deberá configurar un elemento de mapa selementid a un valor arbitrario y luego usar este valor para hacer referencia a este elemento en las propiedades de los enlaces selementid1 o selementid2. Cuando se crea el elemento, este valor será reemplazado por la ID correcta generada por Zabbix. Ver ejemplo.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID de los mapas creados bajo la propiedad sysmapids. El orden de los ID devueltos coincide. el orden de los mapas pasados.

Ejemplos

Crear un mapa vacío

Cree un mapa sin elementos.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map",
               "width": 600,
               "height": 600
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Respuesta:

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

Crear un host de mapa

Cree un mapa con dos elementos de host y un enlace entre ellos. Tenga en cuenta que o uso temporario dos valores "selementid1" y "selementid2" no objeto de enlace de mapa para referirse a los elementos de mapa.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Host map",
               "width": 600,
               "height": 600,
               "selements": [
                   {
                       "selementid": "1",
                       "elements": [
                           {"hostid": "1033"}
                       ],
                       "elementtype": 0,
                       "iconid_off": "2"
                   },
       
                   {
                       "selementid": "2",
                       "elements": [
                           {"hostid": "1037"}
                       ],
                       "elementtype": 0,
                       "iconid_off": "2"
                   }
               ],
               "links": [
                   {
                       "selementid1": "1",
                       "selementid2": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Respuesta:

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

Crear un mapa de trigger

Crear un mapa con elemento de trigger, que contienen dos triggers.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Trigger map",
               "width": 600,
               "height": 600,
               "selements": [
                   {
                       "elements": [
                           {"triggerid": "12345"},
                           {"triggerid": "67890"}
                       ],
                       "elementtype": 2,
                       "iconid_off": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "10"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

Compartir mapas

Cree un mapa con dos tipos de uso compartido (usuario y grupo de usuarios).

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map sharing",
               "width": 600,
               "height": 600,
               "users": [
                   {
                       "userid": "4",
                       "permission": "3"
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": "7",
                       "permission": "2"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Respuesta:

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

Formas del mapa

Cree un mapa con el título del nombre del mapa.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Host map",
               "width": 600,
               "height": 600,
               "shapes": [
                   {
                       "type": 0,
                       "x": 0,
                       "y": 0,
                       "width": 600,
                       "height": 11,
                       "text": "{MAP.NAME}"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "10"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

Líneas de mapa

Cree una línea de mapa.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map API lines",
               "width": 500,
               "height": 500,
               "lines": [
                   {
                       "x1": 30,
                       "y1": 10,
                       "x2": 100,
                       "y2": 50,
                       "line_type": 1,
                       "line_width": 10,
                       "line_color": "009900"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }
Copy
✔ Copied

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "11"
               ]
           },
           "id": 1
       }
Copy
✔ Copied

Ver también

Fuente

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.