itemprototype.create

    This method allows to create new item prototypes.

    This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

    (object/array) Item prototype to create.

    Additionally to the , the method accepts the following parameters.

    (object) Returns an object containing the IDs of the created item prototypes under the itemids property. The order of the returned IDs matches the order of the passed item prototypes.

    Creating an item prototype

    Create an item prototype to monitor free disc space on a discovered file system. Discovered items should be numeric Zabbix agent items updated every 30 seconds.

    Response:

    1. {
    2.            "jsonrpc": "2.0",
    3.            "result": {
    4.                "itemids": [
    5.                    "27666"
    6.                ]
    7.            },
    8.            "id": 1
    9.        }

    Creating an item prototype with preprocessing

    Create an item using change per second and a custom multiplier as a second step.

    Request:

    1. {
    2.            "jsonrpc": "2.0",
    3.            "method": "itemprototype.create",
    4.            "params": {
    5.                "name": "Incoming network traffic on {#IFNAME}",
    6.                "key_": "net.if.in[{#IFNAME}]",
    7.                "hostid": "10001",
    8.                "ruleid": "27665",
    9.                "type": 0,
    10.                "value_type": 3,
    11.                "delay": "60s",
    12.                "units": "bps",
    13.                "interfaceid": "1155",
    14.                "preprocessing": [
    15.                        "type": "10",
    16.                        "params": "",
    17.                        "error_handler": "0",
    18.                        "error_handler_params": ""
    20.                    {
    21.                        "type": "1",
    22.                        "params": "8",
    23.                        "error_handler": "2",
    24.                        "error_handler_params": "10"
    25.                    }
    26.                ]
    27.            },
    28.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
    29.            "id": 1
    30.        }

    Response:

    Creating dependent item prototype

    Create Dependent item prototype for Master item prototype with ID 44211. Only dependencies on same host (template/discovery rule) are allowed, therefore Master and Dependent item should have same hostid and ruleid.

    Request:

    1. {
    2.            "jsonrpc": "2.0",
    3.            "method": "itemprototype.create",
    4.            "params": {
    5.              "hostid": "10001",
    6.              "ruleid": "27665",
    7.              "name": "Dependent test item prototype",
    8.              "key_": "dependent.prototype",
    9.              "type": "18",
    10.              "master_itemid": "44211",
    11.              "value_type": "3"
    12.            },
    13.            "auth": "038e1d7b1735c6a5436ee9eae095879e",
    14.            "id": 1
    15.        }
    1. {
    2.            "jsonrpc": "2.0",
    3.                "itemids": [
    4.                    "44212"
    6.            },
    7.            "id": 1
    8.        }

    Create HTTP agent item prototype

    Create item prototype with URL using user macro, query fields and custom headers.

    Request:

    Response:

    1. {
    2.            "jsonrpc": "2.0",
    3.            "result": {
    4.                "itemids": [
    5.                    "28305"
    6.                ]
    7.            },
    8.            "id": 1
    9.        }

    Create script item prototype

    Create a simple data collection using a script item prototype.

    Request:

    1. {
    2.            "jsonrpc": "2.0",
    3.            "method": "itemprototype.create",
    4.            "params": {
    5.                "name": "Script example",
    6.                "key_": "custom.script.itemprototype",
    7.                "hostid": "12345",
    8.                "type": 21,
    9.                "value_type": 4,
    10.                "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",
    11.                "parameters": [{
    12.                    "name": "host",
    13.                    "value": "{HOST.CONN}"
    14.                }],
    15.                "timeout": "6s",
    16.                "delay": "30s"
    17.            },
    18.            "auth": "038e1d7b1735c6a5436ee9eae095879e",

    Response: