Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

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 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/array) Mapas a crear.

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 que se crearán en el mapa.
selements array Elementos de mapa que se crearán en el mapa.
urls array URLs de mapa que se crearán en el mapa.
users array Comparticiones de usuario de mapa que se crearán en el mapa.
userGroups array Comparticiones de grupo de usuarios de mapa que se crearán en el mapa.
shapes array Formas de mapa que se crearán en el mapa.
lines array Líneas de mapa que se crearán en el mapa.

Para crear enlaces de mapa, deberá establecer un elemento de mapa selementid en un valor arbitrario y luego usar este valor para referenciar este elemento en las propiedades selementid1 o selementid2 de los enlaces. Cuando se cree el elemento, este valor será reemplazado por el ID correcto generado por Zabbix. Vea el 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

Crea un mapa sin elementos.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map",
               "width": 600,
               "height": 600
           },
           "id": 1
       }

Respuesta:

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

Crear un mapa de equipo

Cree un mapa con dos elementos de equipo y un vínculo entre ellos. Observe el uso de valores temporales "selementid1" y "selementid2" en el objeto de enlace del mapa para referirse a elementos del 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"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Crear un mapa de iniciadores

Crear un mapa con elemento de iniciador, que contienen dos iniciadores.

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"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

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"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

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}"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Líneas del mapa

Crea 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"
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Ver también

Fuente

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