Table of Contents
map.create
Beschrijving
objectmap.create(object/array-kaarten)
Met deze methode kunnen nieuwe kaarten worden gemaakt.
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kan worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.
Parameters
(object/array) Kaarten om te maken.
Naast de standaard kaarteigenschappen, is de methode accepteert de volgende parameters.
| Parameter | Type | Beschrijving |
|---|---|---|
| links | array | Kaart links die op de kaart moet worden gemaakt. |
| selements | array | Kaart elementen die op de kaart moet worden gemaakt. |
| urls | array | Kaart URL's die op de kaart moet worden gemaakt. |
| users | array | Map gebruiker aandelen die op de kaart moeten worden gemaakt. |
| userGroups | array | Map gebruikersgroep aandelen die op de kaart moeten worden gemaakt. |
| shapes | array | Kaart vormen die op de kaart moet worden gemaakt. |
| lines | array | Kaart lijnen die op de kaart moet worden gemaakt. |
Om kaartkoppelingen te maken, moet je een kaartelement instellen selementid naar een willekeurige waarde en gebruik dan deze waarde om te verwijzen dit element in de eigenschappen van de koppelingen selementid1 of selementid2. Wanneer het element is gemaakt, wordt deze waarde vervangen door de juiste ID gegenereerd door Zabbix. Zien voorbeeld.
Retourwaarden
(object) Retourneert een object dat de ID's van de gemaakte kaarten bevat onder de eigenschap sysmapids. De volgorde van de geretourneerde ID's komt overeen de volgorde van de doorgegeven kaarten.
Voorbeelden
Maak een lege kaart
Maak een kaart zonder elementen.
Verzoek:
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Map",
"width": 600,
"height": 600
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Antwoord:
Maak een hostmap
Maak een kaart met twee hostelementen en een link daartussen. Merk op gebruik van tijdelijke "selementid1" en "selementid2" waarden in de kaartlink object om naar kaartelementen te verwijzen.
Verzoek:
{
"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
}Antwoord:
Maak een triggermap
Maak een kaart met trigger-element, die twee triggers bevat.
Verzoek:
{
"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
}Antwoord:
Kaart delen
Maak een kaart met twee soorten delen (gebruiker en gebruikersgroep).
Verzoek:
{
"jsonrpc": "2.0",
"methode": "map.create",
"parameters": {
"name": "Kaart delen",
"breedte": 600,
"hoogte": 600,
"gebruikers": [
{
"use-ID": "4",
"toestemming": "3"
}
],
"gebruikersgroepen": [
{
"usrgrpid": "7",
"toestemming": "2"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Antwoord:
Kaartvormen
Maak een kaart met de titel van de kaartnaam.
Verzoek:
{
"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
}Antwoord:
Kaartlijnen
Maak een kaartlijn.
Verzoek:
{
"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
}Antwoord:
Zie ook
Bron
CMap::create() in ui/include/classes/api/services/CMap.php.