Это перевод страницы документации с английского языка. Помогите нам сделать его лучше.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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"
                   }
               ]
           },
           "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.