map.create

Опис

object map.create(object/array maps)

Овај метод вам омогућава креирање нових мапа.

Овај метод је доступан корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Корисничке улоге за више информација.

Параметри

(object/array) Мапе за креирање.

Поред стандардних својстава мапе, метод прихвата следеће параметре.

Parameter Type Description
links array Везе мапе које ће се креирати на мапи.
selements array Елементи мапе који ће се креирати на мапи.
urls array URL мапе који ће се креирати на мапи.
users array Корисничка мапа дељења која ће се креирати на мапи.
userGroups array Мапа корисничке групе дељења која ће се креирати на мапи.
shapes array Облици мапе који ће се креирати на мапи.
lines array Линије карте које ће се креирати на мапи.

Да бисте креирали везе на мапи, мораћете да поставите елемент мапе selementid на произвољну вредност, а затим користите ову вредност за референцирање тог елемента у особинама веза selementid1 или selementid2. Када се елемент креира, ова вредност ће бити замењена са одговарајућим ID-ијем који је креирао Zabbix. Погледајте пример.

Повратне вредности

(object) Враћа објекат који садржи ID-ијеве креираних мапа под својством sysmapids. Редослед враћених ID-ијева се подудара са редоследом прослеђених мапа.

Примери

Креирање празне мапе

Креирајте мапу без елемената.

Захтев:

{
           "jsonrpc": "2.0",
           "method": "map.create",
           "params": {
               "name": "Map",
               "width": 600,
               "height": 600
           },
           "id": 1
       }

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "8"
               ]
           },
           "id": 1
       }

Креирање мапе домаћина

Креирајте мапу са два елемента домаћина и везом између њих. Обратите пажњу на коришћење привремених вредности "selementid1" и "selementid2" у објекту повезивања мапе за упућивање на елементе мапе.

Захтев:

{
           "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
       }

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "9"
               ]
           },
           "id": 1
       }

Креирење мапе окидача

Креирајте мапу са елементима окидача, који садрже два окидача.

Захтев:

{
           "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
       }

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "10"
               ]
           },
           "id": 1
       }

Дељење мапе

Креирајте мапу са два типа дељења (корисник и група корисника).

Захтев:

{
           "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
       }

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "9"
               ]
           },
           "id": 1
       }

Облици мапе

Креирајте мапу са насловом мапе.

Захтев:

{
           "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
       }

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "10"
               ]
           },
           "id": 1
       }

Линије мапе

Креирајте линију мапе.

Захтев:

{
           "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
       }

Одговор:

{
           "jsonrpc": "2.0",
           "result": {
               "sysmapids": [
                   "11"
               ]
           },
           "id": 1
       }

Погледајте такође

Извор

CMap::create() у ui/include/classes/api/services/CMap.php.