map.create

Apraksts

object map.create(object/array maps)

Šī metode ļauj izveidot jaunas kartes.

Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object/array) Kartes, ko izveidot.

Papildus standarta kartes īpašībām metode pieņem šādus parametrus.

Parametrs Tips Apraksts
links array Kartes saites, kas jāizveido kartē.
selements array Kartes elementi, kas jāizveido kartē.
urls array Kartes URL, kas jāizveido kartē.
users array Kartes lietotāju koplietošanas ieraksti, kas jāizveido kartē.
userGroups array Kartes lietotāju grupu koplietošanas ieraksti, kas jāizveido kartē.
shapes array Kartes formas, kas jāizveido kartē.
lines array Kartes līnijas, kas jāizveido kartē.

Lai izveidotu kartes saites, jums būs jāiestata kartes elementa selementid uz patvaļīgu vērtību un pēc tam jāizmanto šī vērtība, lai atsauktos uz šo elementu saišu īpašībās selementid1 vai selementid2. Kad elements tiks izveidots, šī vērtība tiks aizstāta ar pareizo ID, ko ģenerējis Zabbix. Skatīt piemēru.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur izveidoto karšu ID īpašībā sysmapids. Atgriezto ID secība atbilst nodoto karšu secībai.

Piemēri

Izveidot tukšu karti

Izveidojiet karti bez elementiem.

Pieprasījums:

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

Atbilde:

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

Izveidot hostu karti

Izveidojiet karti ar diviem hosta elementiem un saiti starp tiem. Ņemiet vērā pagaidu "selementid1" un "selementid2" vērtību izmantošanu kartes saites objektā, lai atsauktos uz kartes elementiem.

Pieprasījums:

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

Atbilde:

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

Izveidot trigeru karti

Izveidojiet karti ar trigeru elementu, kurā ir divi trigeri.

Pieprasījums:

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

Atbilde:

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

Kartes kopīgošana

Izveidojiet karti ar diviem kopīgošanas veidiem (lietotājs un lietotāju grupa).

Pieprasījums:

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

Atbilde:

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

Kartes formas

Izveidojiet karti ar kartes nosaukumu virsrakstā.

Pieprasījums:

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

Atbilde:

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

Kartes līnijas

Izveidojiet kartes līniju.

Pieprasījums:

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

Atbilde:

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

Skatiet arī

Avots

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