Sidebar
api:map:create
Table of Contents
create()
This function allows you to create a map as defined by the map data array.
Parameters
| Parameter | Type | Optional | Description | Details |
|---|---|---|---|---|
| map data | array or object | Array of Map objects or a single object with additional paramter selements, array of map item objects | sysmapid shouldn't be specified |
Returns
| Parameter | Description |
|---|---|
| result | Operation successful. Result will contain array of created Map IDs. sysmapid is assigned to each Map object |
| error | In case of any errors |
Example
Create new map
{ "jsonrpc": "2.0", "method": "map.create", "params": [{ "selements": [{ "elementid": "0", "elementtype": "4", "iconid_off": "100100000000036", "iconid_on": "0", "iconid_unknown": "0", "label": "New element", "label_location": "0", "x": "200", "y": "100", "url": "", "iconid_disabled": "0", "iconid_maintenance": "0" }], "name": "ZABBIX-Map", "width": "800", "height": "600", "backgroundid": "0", "label_type": "0", "label_location": "0", "highlight": 0, "expandproblem": 0, "markelements": 0, "show_unack": 0 }], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 }
Map created successfully:
{ "jsonrpc": "2.0", "result": { "sysmapids": ["100100000012213"] }, "id": 2 }
Map already exists:
{ "jsonrpc": "2.0", "error": { "code": -32602, "message": "Invalid params.", "data": "[ CMap::create ] Map [ ZABBIX-Map ] already exists" }, "id": 2 }