Documentation
Table of Contents
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
}Respuesta:
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
}Respuesta:
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
}Respuesta:
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
}Respuesta:
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
}Respuesta:
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
}Respuesta:
Ver también
Fuente
CMap::create() en ui/include/classes/api/services/CMap.php.