Documentation
Table of Contents
map.create
Descripció
object map.create(object/array maps)
Aquest mètode permet crear mapes nous.
Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu Rols d'usuari.
Paràmetres
(object/array) Mapes a crear.
A més de les [propietats d'objecte de mapa estàndard] (object#map), el mètode admet els paràmetres següents.
| Paràmetre | Tipus | Descripció |
|---|---|---|
| links | array | Enllaços de mapes per crear al mapa. |
| selements | array | Elements del mapa per crear al mapa. |
| urls | array | URL del mapa per crear al mapa. |
| users | array | Recursos d'usuari compartits del mapa per crear al mapa. |
| userGroups | array | Recursos compartits de grups d'usuaris del mapa per crear al mapa. |
| shapes | array | Formes del mapa per crear al mapa. |
| lines | array | Línies de mapa per crear al mapa. |
Per crear enllaços de mapa, cal establir un element de mapa selementid amb un valor arbitrari i després emprar aquest valor per fer referència a aquest element a les propietats d'enllaç selementid1 o selementid2. En crear l'element, aquest valor serà substituït per l'identificador correcte generat per Zabbix. Veieu exemple.
Valors de retorn
(object) Retorna un objecte amb els IDs dels mapes creats segons la propietat sysmapids. L'ordre dels IDs retornats correspon a l'ordre dels mapes donats.
Exemples
Crear un mapa buit
Crear un mapa sense elements.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"id": 1
}Resposta:
Crear un mapa d'equips
Crear un mapa amb dos equips i un enllaç entre ells. Tindre en compte que emprar els valors temporals "selementid1" i "selementid2" dins l'objecte vinculat del mapa pot fer referència els elements 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
}Resposta:
Crear un mapa de triggers
Crear un mapa un element de trigger, que contenen dos triggers.
{
"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
}Resposta:
compartir un mapa
Crear un mapa amb dos tipus de compartició (usuari i grup d'usuaris).
{
"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
}Resposta:
Formes de mapa
Crear un mapa amb un títol.
{
"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
}Resposta:
Línies de mapes
Crear una línia 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
}Resposta:
Veieu també
- Element de mapa
- Enllaç de mapa
- URL de mapa
- usuari del mapa
- Grup d'usuaris del mapa
- Forma de mapes
- Línia de mapes
Font
CMap::create() in ui/include/classes/api/services/CMap.php.