Documentation
Table of Contents
map.create
Leírás
object map.create(object/array maps)
Ez a módszer lehetővé teszi új térképek létrehozását.
Ez a módszer bármilyen típusú felhasználó számára elérhető. Engedélyek A metódus meghívása a felhasználói szerepkör beállításaiban visszavonható. Lásd: User roles további információért.
Paraméterek
(objektum/tömb) Létrehozandó térképek.
A standard térképtulajdonságok mellett a metódus elfogadja a következő paramétereket.
| Paraméter | Típus | Leírás |
|---|---|---|
| links | array | Térkép linkek létrehozandó a térképen. |
| selements | array | Térkép elemek létrehozandó a térképen. |
| urls | array | Létrehozandó URL-ek térképen. |
| users | array | Térképes user megosztásokat létrehozni a térképen. |
| userGroups | array | Map user group megosztások létrehozása a térképen. |
| shapes | array | Térkép alakzatok létrehozandó a térképen. |
| vonalak | tömb | Térkép vonalak létrehozandó a térképen. |
Térképhivatkozások létrehozásához be kell állítania egy térképelemet selementid egy tetszőleges értékre, majd használja ezt az értéket a hivatkozáshoz ez az elem a linkek selementid1 vagy selementid2 tulajdonságaiban. Az elem létrehozásakor ezt az értéket a rendszer a következőre cseréli a Zabbix által generált helyes azonosító. Lát példa.
Visszatérési értékek
(object) A létrehozott térképek azonosítóit tartalmazó objektumot ad eredményül a sysmapids tulajdonság alatt. A visszaküldött azonosítók sorrendje megegyezik az átadott térképek sorrendje.
Példák
Hozzon létre egy üres térképet
Készítsen térképet elemek nélkül.
Kérés:
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Térkép",
"width": 600,
"height": 600
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Válasz:
Create a host map
Create a map with two host elements and a link between them. Note the use of temporary "selementid1" and "selementid2" values in the map link object to refer to map elements.
Request:
{
"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
}Response:
Create a trigger map
Create a map with trigger element, which contains two triggers.
Request:
{
"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
}Response:
Map sharing
Create a map with two types of sharing (user and user group).
Request:
{
"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
}Response:
Map shapes
Create a map with map name title.
Request:
{
"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
}Response:
Map lines
Create a map line.
Request:
{
"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
}Response:
Lásd még
- Térképelem
- Térképlink
- Térkép URL
- Térképfelhasználó
- Térkép felhasználói csoport
- Térkép alakzat
- Térképvonal
Forrás
CMap::create() az ui/include/classes/api/services/CMap.php-ban.