Sidebar

ru:manual:api:reference:item:create

item.create

Описание

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

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

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

Параметры

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

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

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

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

(объект) Возвращает объект, который содержит 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": 30
    },
    "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": 10,
        "inventory_link": 5
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Ответ:

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

Исходный код

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