Documentation
Table of Contents
map.create
Beschrijving
object map.create(object/array maps)
Deze methode maakt het mogelijk om nieuwe kaarten te maken.
Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen 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 aan
Maak een kaart aan zonder elementen.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Kaart",
"width": 600,
"height": 600
},
"id": 1
}Antwoord:
Maak een hostkaart aan
Maak een kaart aan met twee hostelementen en een link tussen hen. Let op het gebruik van tijdelijke waarden "selementid1" en "selementid2" in het kaartlinkobject om te verwijzen naar kaartelementen.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Hostkaart",
"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
}Antwoord:
Maak een triggervisualisatiekaart aan
Maak een kaart aan met een triggerelement dat twee triggers bevat.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Triggervisualisatiekaart",
"width": 600,
"height": 600,
"selements": [
{
"elements": [
{"triggerid": "12345"},
{"triggerid": "67890"}
],
"elementtype": 2,
"iconid_off": "2"
}
]
},
"id": 1
}Antwoord:
Kaart delen
Maak een kaart aan met twee soorten delen (gebruiker en gebruikersgroep).
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Kaart delen",
"width": 600,
"height": 600,
"users": [
{
"userid": "4",
"permission": "3"
}
],
"userGroups": [
{
"usrgrpid": "7",
"permission": "2"
}
]
},
"id": 1
}Antwoord:
Kaartvormen
Maak een kaart aan met de kaartnaam als titel.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Hostkaart",
"width": 600,
"height": 600,
"shapes": [
{
"type": 0,
"x": 0,
"y": 0,
"width": 600,
"height": 11,
"text": "{MAP.NAME}"
}
]
},
"id": 1
}Antwoord:
Kaartlijnen
Maak een kaartlijn aan.
{
"jsonrpc": "2.0",
"method": "map.create",
"params": {
"name": "Kaart API-lijnen",
"width": 500,
"height": 500,
"lines": [
{
"x1": 30,
"y1": 10,
"x2": 100,
"y2": 50,
"line_type": 1,
"line_width": 10,
"line_color": "009900"
}
]
},
"id": 1
}Antwoord:
Zie ook
Bron
CMap::create() in ui/include/classes/api/services/CMap.php.