Sidebar

ru:manual:api:reference:item:create

item.create

Описание

объект item.create(объект/массив элементы данных)

Этот метод позволяет создавать новые элементы данных.

Веб элементы данных нельзя создавать через Zabbix API.

Параметры

(объект/массив) Создаваемые элементы данных.

В дополнение к стандартным свойствам элемента данных, этот метод принимает следующие параметры.

Параметр Тип Описание
applications массив ID добавляемых групп элементов данных к элементам данных.
preprocessing массив Опции предварительной обработки элемента данных.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных элементов данных под свойством itemids. Порядок возвращаемых ID совпадает с порядком переданных элементов данных.

Примеры

Создание элемента данных

Создание числового элемента данных с типом Zabbix агент для наблюдения за свободным дисковым пространством на узле сети с ID “30074” и добавление этого элемента данных в две группы элементов данных.

Запрос:

{
    "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
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "24758"
        ]
    },
    "id": 1
}

Создание элемента данных инвентаря узла сети

Создание элемента данных с типом Zabbix агент, который будет заполнять поле “ОС” инвентарных данных узла сети.

Запрос:

{
    "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
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "24759"
        ]
    },
    "id": 1
}

Создание элемента данных с предобработкой

Создание элемента данных, который использует пользовательский множитель.

Запрос:

{
    "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
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "44210"
        ]
    },
    "id": 1
}

Создание зависимого элемента данных

Создание зависимого элемента данных от основного элемента данных с ID 24759. Зависимости разрешены только в пределах одного узла сети, поэтому у основного и зависимого элементов данных должен быть одинаковый hostid.

Запрос:

{
    "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
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "44211"
        ]
    },
    "id": 1
}

Создание элемента данных HTTP агента

Создание элемента данных с методом POST запроса и с предобработкой JSON ответа.

Запрос:

{
    "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
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "itemids": [
            "23865"
        ]
    },
    "id": 3
}

Исходный код

CItem::create() в frontends/php/include/classes/api/services/CItem.php.