Sidebar

pt:api:action:create

Table of Contents

create()

This function allows you to create a action as defined by the action data array.

Parameters

ParameterTypeOptionalDescriptionDetails
action dataarray or object Array of Action objects with additional paramters operations and conditions actionid shouldn't be specified
action conditions dataarray or object array of action conditions objects
action operations dataarray or object array of action operations objects

Returns

ParameterDescription
resultOperation successful. Result will contain array of created Action IDs. actionid are assigned to each Action object
errorIn case of any errors

Example

Create new action

{
"jsonrpc":"2.0",
"method":"action.create",
"params":[{
	"name":"ZABBIX ACTION",
	"eventsource":"0",
	"evaltype":"0",
	"status":"1",
	"esc_period":"3600",
	"def_shortdata":"{TRIGGER.NAME}: {STATUS}",
	"def_longdata":"{TRIGGER.NAME}: {STATUS}",
	"recovery_msg":"0",
	"r_shortdata":"{TRIGGER.NAME}: {STATUS}",
	"r_longdata":"{TRIGGER.NAME}: {STATUS}",
	"conditions":[{
		"conditiontype":"3",
		"operator":"2",
		"value":"TEST"
	},{
		"conditiontype":"1",
		"operator":"1",
		"value":"100100000010096"
	}],
	"operations":[{
		"operationtype":"0",
		"object":"0",
		"objectid":"100100000000017",
		"shortdata":"{TRIGGER.NAME}: {STATUS}",
		"longdata":"{TRIGGER.NAME}: {STATUS}",
		"esc_period":"0",
		"esc_step_from":"1",
		"esc_step_to":"1",
		"default_msg":"1",
		"evaltype":"0",
		"opconditions":[],
		"opmediatypes":[]
	},{
		"operationtype":"0",
		"object":"0",
		"objectid":"100100000000001",
		"shortdata":"{TRIGGER.NAME}: {STATUS}",
		"longdata":"{TRIGGER.NAME}: {STATUS}",
		"esc_period":"0",
		"esc_step_from":"2",
		"esc_step_to":"3",
		"default_msg":"1",
		"evaltype":"0",
		"opconditions":[],
		"opmediatypes":[{
			"mediatypeid":"100100000000001"
		}]
	},{
		"operationtype":"0",
		"object":"0",
		"objectid":"100100000000003",
		"shortdata":"{TRIGGER.NAME}: {STATUS}",
		"longdata":"{TRIGGER.NAME}: {STATUS}",
		"esc_period":"0",
		"esc_step_from":"3",
		"esc_step_to":"4",
		"default_msg":"1",
		"evaltype":"0",
		"opconditions":[{
			"conditiontype":"14",
			"operator":"0",
			"value":"0"
		},{
			"conditiontype":"14",
			"operator":"0",
			"value":"1"
		}],
		"opmediatypes":[{
			"mediatypeid":"100100000000001"
		}]
	}]
}],
"auth":"038e1d7b1735c6a5436ee9eae095879e",
"id":2
}

Action created successfully:

{
"jsonrpc":"2.0",
"result":{
	"actionids":["100100000012213"]
},
"id":2
}

Action already exists:

{
"jsonrpc":"2.0",
"error":{
      "code":-32602,
      "message":"Invalid params.",
      "data":"[ CAction::create ] Action [ ZABBIX Server ] already exists"
},
"id":2
}