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 llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para obtener 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 a crear en el mapa. |
| selements | array | Elementos de mapa a crear en el mapa. |
| urls | array | URLs de mapa a crear en el mapa. |
| users | array | Comparticiones de usuario de mapa a crear en el mapa. |
| userGroups | array | Comparticiones de grupo de usuarios de mapa a crear en el mapa. |
| shapes | array | Formas de mapa a crear en el mapa. |
| lines | array | Líneas de mapa a crear en el mapa. |
Para crear enlaces de mapa necesitará establecer un selementid de elemento de mapa a 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. Ver ejemplo.
Valores de retorno
(object) Devuelve un objeto que contiene los IDs de los mapas creados bajo la propiedad sysmapids. El orden de los IDs devueltos coincide con el orden de los mapas enviados.
Ejemplos
Crear un mapa vacío
Crea un mapa sin elementos.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"id": 1
}Respuesta:
Crear un mapa de equipos
Cree un mapa con dos elementos de equipo y un enlace entre ellos. Observe el uso de valores temporales "selementid1" y "selementid2" en el objeto de enlace del mapa para hacer referencia a los 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 de disparadores
Cree un mapa con un elemento de disparador, que contenga dos disparadores.
{
"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:
Compartir mapa
Crear un mapa con dos tipos de compartición (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:
Formas de mapa
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:
Líneas de mapa
Crear 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:
Véase también
- Elemento de mapa
- Enlace de mapa
- URL de mapa
- Usuario de mapa
- Grupo de usuarios de mapa
- Forma de mapa
- Línea de mapa
Fuente
CMap::create() en ui/include/classes/api/services/CMap.php.