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:

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

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:

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

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:

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

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:

{
    "jsonrpc": "2.0",
    "resultaat": {
        "sysmapiden": [
            "9"
        ]
    },
    "id": 1
}

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:

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

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:

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

Zie ook

Bron

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