item.update

Описание

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

Этот метод позволяет обновлять существующие элементы данных.

Параметры

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

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

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

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

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

Примеры

Активация элемента данных

Активация элемента данных, то есть изменение его состояния на значение "0".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "10092",
        "status": 0
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Ответ:

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

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

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

Запрос:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "name": "Dependent item updated name",
        "master_itemid": "25562",
        "itemid": "189019"
    },
    "auth": "700ca65537074ec963db7efabda78259",
    "id": 1
}

Ответ:

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

Исходный код

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