map.create

Descrizione

object map.create(object/array maps)

Questo metodo consente di creare nuove mappe.

Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere User roles per ulteriori informazioni.

Parametri

(object/array) Mappe da creare.

Oltre alle proprietà standard della mappa, il metodo accetta i seguenti parametri.

Parametro Type Descrizione
links array Collegamenti della mappa da creare nella mappa.
selements array Elementi della mappa da creare nella mappa.
urls array URL della mappa da creare nella mappa.
users array Condivisioni utente della mappa da creare nella mappa.
userGroups array Condivisioni dei gruppi utenti della mappa da creare nella mappa.
shapes array Forme della mappa da creare nella mappa.
lines array Linee della mappa da creare nella mappa.

Per creare collegamenti della mappa, è necessario impostare selementid di un elemento della mappa su un valore arbitrario e quindi usare questo valore per fare riferimento a tale elemento nelle proprietà del collegamento selementid1 o selementid2. Quando l'elemento viene creato, questo valore verrà sostituito con l'ID corretto generato da Zabbix. Vedi esempio.

Restituisce i valori

(object) Restituisce un oggetto contenente gli ID delle mappe create sotto la proprietà sysmapids. L'ordine degli ID restituiti corrisponde all'ordine delle mappe passati.

Esempi

Creare una mappa vuota

Creare una mappa senza elementi.

Richiesta:

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

Risposta:

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

Creare una mappa di host

Creare una mappa con due elementi host e un collegamento tra di essi. Notare l'uso dei valori temporanei "selementid1" e "selementid2" nell'oggetto del collegamento della mappa per fare riferimento agli elementi della mappa.

Request:

{
    "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"
            }
        ]
    },
    "id": 1
}

Risposta:

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

Creare una mappa di trigger

Creare una mappa con un elemento trigger, che contiene due trigger.

Richiesta:

{
    "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"
            }
        ]
    },
    "id": 1
}

Risposta:

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

Condivisione della mappa

Creare una mappa con due tipi di condivisione (utente e gruppo di utenti).

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "map.create",
    "params": {
        "name": "Map sharing",
        "width": 600,
        "height": 600,
        "users": [
            {
                "userid": "4",
                "permission": "3"
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": "2"
            }
        ]
    },
    "id": 1
}

Risposta:

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

Forme della mappa

Crea una mappa con il titolo del nome della mappa.

Richiesta:

{
    "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}"
            }
        ]
    },
    "id": 1
}

Risposta:

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

Linee della mappa

Crea una linea della mappa.

Richiesta:

{
    "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"
            }
        ]
    },
    "id": 1
}

Risposta:

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

Vedi anche

Fonte

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