object item.create(object/array items)
This method allows to create new items.
(object/array)
Items to create.
Additionally to the standard item properties, the method accepts the following parameters.
Parameter | Type | Description |
---|---|---|
applications | array | IDs of the applications to add the item to. |
preprocessing | array | Item preprocessing options. |
(object)
Returns an object containing the IDs of the created items under the itemids
property. The order of the returned IDs matches the order of the passed items.
Create a numeric Zabbix agent item to monitor free disk space on host with ID “30074” and add it to two applications.
Request:
{ "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Free disk space on $1", "key_": "vfs.fs.size[/home/joe/,free]", "hostid": "30074", "type": 0, "value_type": 3, "interfaceid": "30084", "applications": [ "609", "610" ], "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
Response:
{ "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 }
Create a Zabbix agent item to populate the host's “OS” inventory field.
Request:
{ "jsonrpc": "2.0", "method": "item.create", "params": { "name": "uname", "key_": "system.uname", "hostid": "30021", "type": 0, "interfaceid": "30007", "value_type": 1, "delay": "10s", "inventory_link": 5 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
Response:
{ "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 }
Create an item using custom multiplier.
Request:
{ "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "11312", "type": 4, "snmp_community": "{$SNMP_COMMUNITY}", "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "units": "uptime", "interfaceid": "1156", "preprocessing": [ { "type": "1", "params": "0.01", "error_handler": "1", "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
Response:
{ "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 }
Create a dependent item for the master item with ID 24759. Only dependencies on the same host are allowed, therefore master and the dependent item should have the same hostid.
Request:
{ "jsonrpc": "2.0", "method": "item.create", "params": { "hostid": "30074", "name": "Dependent test item", "key_": "dependent.item", "type": "18", "master_itemid": "24759", "value_type": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }
Response:
{ "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 }
Create POST request method item with JSON response preprocessing.
Request:
{ "jsonrpc": "2.0", "method": "item.create", "params": { "url":"http://127.0.0.1/http.php", "query_fields": [ { "mode":"json" }, { "min": "10" }, { "max": "100" } ], "interfaceid": "1", "type":"19", "hostid":"10254", "delay":"5s", "key_":"json", "name":"http agent example JSON", "value_type":"0", "output_format":"1", "preprocessing": [ { "type": "12", "params": "$.random" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 }
Response:
{ "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 }
CItem::create() in frontends/php/include/classes/api/services/CItem.php.