Table of Contents

item.update

item.update

Descrição

object item.update(object/array items)

Este método permite atualizar items existentes.

Items web não podem ser atualizados via API do Zabbix.

Este método está disponível apenas para os tipos de usuário Admin e Super admin. As permissões para chamar o método podem ser revogadas nas configurações de função de usuário. Veja Funções de usuário para mais informações.

Parâmetros

(object/array) Propriedades do item a serem atualizadas.

A propriedade itemid deve ser definida para cada item, todas as outras propriedades são opcionais. Somente as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.

Além das propriedades padrão do item, o método aceita os seguintes parâmetros.

Parâmetro	Tipo	Descrição
preprocessing	array	Opções de pré-processamento do item para substituir as opções de pré-processamento atuais. Comportamento do parâmetro: - somente leitura para objetos herdados ou objetos descobertos
tags	array	Tags do item. Comportamento do parâmetro: - somente leitura para objetos descobertos

Valores de retorno

(object) Retorna um objeto contendo os IDs dos items atualizados na propriedade itemids.

Exemplos

Habilitando um item

Habilite um item, ou seja, defina seu status como "0".

Requisição:

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

Resposta:

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

Atualizar item dependente

Atualize o nome do item dependente e o ID do item mestre. Apenas dependências no mesmo host são permitidas, portanto, o item mestre e o item dependente devem ter o mesmo hostid.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "name": "Nome atualizado do item dependente",
               "master_itemid": "25562",
               "itemid": "189019"
           },
           "id": 1
       }

Resposta:

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

Atualizar item HTTP agent

Habilitar o trapping de valor do item.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "23856",
               "allow_traps": 1
           },
           "id": 1
       }

Resposta:

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

Atualizando um item com pré-processamento

Atualize um item com a regra de pré-processamento "No intervalo".

Requisição:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "23856",
               "preprocessing": [
                   {
                       "type": 13,
                       "params": "\n100",
                       "error_handler": 1,
                       "error_handler_params": ""
                   }
               ]
           },
           "id": 1
       }

Resposta:

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

Atualizando um item de script

Atualize um item de script com um script diferente e remova parâmetros desnecessários que eram usados pelo script anterior.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "item.update",
           "params": {
               "itemid": "23865",
               "parameters": [],
               "script": "Zabbix.log(3, 'Log test');\nreturn 1;"
           },
           "id": 1
       }

Resposta:

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

Fonte

CItem::update() em ui/include/classes/api/services/CItem.php.

Documentation

item.update

Descrição

Parâmetros

Valores de retorno

Exemplos

Habilitando um item

Atualizar item dependente

Atualizar item HTTP agent

Atualizando um item com pré-processamento

Atualizando um item de script

Fonte