Documentation
6.0
Polski
Table of Contents
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
}Copy
✔ Copied
Odpowiedź:
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
}Copy
✔ Copied
Odpowiedź:
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
}Copy
✔ Copied
Odpowiedź:
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
}Copy
✔ Copied
Odpowiedź:
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
}Copy
✔ Copied
Odpowiedź:
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
}Copy
✔ Copied
Odpowiedź:
Zobacz także
- Element mapy
- Połączenia mapy
- URL mapy
- Użytkownik mapy
- Grupa użytkowników mapy
- Kształt mapy
- Linia mapy
Źródło
CMap::create() w ui/include/classes/api/services/CMap.php.