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.

Aanvraag:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Kaart",
        "width": 600,
        "height": 600
    },
    "id": 1
}

Antwoord:

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

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.

Aanvraag:

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

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

Maak een triggervisualisatiekaart aan

Maak een kaart aan met een triggerelement dat twee triggers bevat.

Aanvraag:

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

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

Kaart delen

Maak een kaart aan met twee soorten delen (gebruiker en gebruikersgroep).

Aanvraag:

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

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

Kaartvormen

Maak een kaart aan met de kaartnaam als titel.

Aanvraag:

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

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

Kaartlijnen

Maak een kaartlijn aan.

Aanvraag:

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

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

Zie ook

Bron

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