Zabbix Documentation 1.8

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


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 OptionalDescriptionDetails
map dataarray or object Array of Map objects or a single object with additional paramter selements, array of map item objectssysmapid shouldn't be specified

Returns

Parameter Description
resultOperation 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
}