Table of Contents

map.create

map.create

Opis

object map.create(object/array maps)

Ta metoda umożliwia tworzenie nowych map.

Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia do jej wywołania mogą zostać cofnięte w ustawieniach ról użytkownika. Zobacz Role użytkowników , aby uzyskać więcej informacji.

Parametry

(object/array) Mapy do utworzenia.

Oprócz standardowych właściwości mapy, metoda akceptuje następujące parametry.

Parametr	Typ	Opis
links	array	Połączenia mapy do utworzenia na mapie.
selements	array	Elementy mapy do utworzenia na mapie.
urls	array	Adresy URL mapy do utworzenia na mapie.
users	array	Użytkownicy współdzielenia mapy do utworzenia na mapie.
userGroups	array	Grupy użytkowników współdzielenia mapy do utworzenia na mapie.
shapes	array	Kształty mapy do utworzenia na mapie.
lines	array	Linie mapy do utworzenia na mapie.

Aby utworzyć połączenia mapy, musisz ustawić element mapy selementid na dowolną wartość, a następnie użyć tej wartości do odwołania się do tego elementu w właściwościach połączenia selementid1 lub selementid2. Gdy element zostanie utworzony, ta wartość zostanie zastąpiona przez poprawne ID wygenerowane przez Zabbix. Zobacz przykład.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory utworzonych map we właściwości sysmapids. Kolejność zwróconych identyfikatorów zgadza się z kolejnością przekazanych map.

Przykłady

Utwórz pustą mapę

Utwórz mapę bez elementów.

Zapytanie:

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

Odpowiedź:

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

Utwórz mapę hosta

Utwórz mapę z dwoma elementami typu host i połączeniem między nimi. Zauważ użycie tymczasowych wartości "selementid1" i "selementid2" w obiekcie połączenia mapy do odwołania się do elementów mapy.

Zapytanie:

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

Odpowiedź:

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

Utwórz mapę wyzwalaczy

Utwórz mapę z elementem wyzwalacza, który zawiera dwa wyzwalacze.

Zapytanie:

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

Odpowiedź:

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

Udostępnianie mapy

Utwórz mapę z dwoma rodzajami współdzielenia (użytkownik i grupa użytkowników).

Zapytanie:

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

Odpowiedź:

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

Kształty mapy

Utwórz mapę z tytułem nazwy mapy.

Zapytanie:

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

Odpowiedź:

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

Linie mapy

Utwórz linię mapy.

Zapytanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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

Documentation

map.create

Opis

Parametry

Zwracane wartości

Przykłady

Utwórz pustą mapę

Utwórz mapę hosta

Utwórz mapę wyzwalaczy

Udostępnianie mapy

Kształty mapy

Linie mapy

Zobacz także

Źródło