Documentation
Table of Contents
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
}Ответ:
Создание элемента данных инвентаря узла сети
Создание элемента данных с типом 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",
"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
}Ответ:
Создание зависимого элемента данных
Создание зависимого элемента данных от основного элемента данных с 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
}Ответ:
Создание элемента данных 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
}Ответ:
Исходный код
CItem::create() в frontends/php/include/classes/api/services/CItem.php.