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.
(objeto/matriz)
Mapas para crear.
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 que se crearán en el mapa. |
selements | matriz | Elementos de mapa que se crearán en el mapa. |
urls | matriz | URL de mapa que se crearán en el mapa. |
users | matriz | Usuario del mapa que pueden compartir el mapa y que se crearán en el mapa. |
userGroups | matriz | Asignar recursos compartidos de grupo de usuarios que se crearán en el mapa. |
shapes | matriz | Formas del mapa que se crearán en el mapa. |
lines | matriz | Líneas de mapa que se crearán 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.
(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.
Crea un mapa sin elementos.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"id": 1
}
Respuesta:
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.
{
"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:
Crear un mapa con elemento de iniciador, que contienen dos iniciadores.
{
"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:
Cree un mapa con dos tipos de uso compartido (usuario y grupo de usuarios).
{
"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:
Cree un mapa con el título del nombre del mapa.
{
"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:
Crea una línea de mapa.
{
"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:
CMap::create() en ui/include/classes/api/services/CMap.php.