Documentation

Table of Contents

item.update

item.update

Descrição

object item.update(object/array items)

Este método permite atualizar itens existentes.

Itens da web não podem ser atualizados através da API Zabbix.

Este método está disponível apenas para Admin e Superadministrador tipos de usuário. As permissões para chamar o método podem ser revogadas na função de usuário definições. Veja Usuário funções Para maiores informações.

Parâmetros

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

A propriedade itemid deve ser definida para cada item, todos os outros propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas outros permanecerão inalterados.

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

|Parâmetro|Tipo|Descrição| |---------|----------------------------------- ------------|-----------| |preprocessing|array|Pré-processamento de item opções para substituir as opções de pré-processamento atuais.| |tags|array|Item tags.|

Valores de retorno

(object) Retorna um objeto contendo os IDs dos itens atualizados sob a propriedade itemids.

Exemplos

Habilitando um item

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

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "item.atualização",
           "parâmetros": {
               "itemid": "10092",
               "estado": 0
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "items": [
                   "10092"
               ]
           },
           "id": 1
       }

Atualizar item dependente

Atualize o nome do item dependente e o ID do item mestre. Apenas dependências do mesmo host são permitidos, portanto, o item Mestre e Dependente deve ter o mesmo hostid.

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "item.atualização",
           "parâmetros": {
               "name": "Nome atualizado do item dependente",
               "master_itemid": "25562",
               "itemid": "189019"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "items": [
                   "189019"
               ]
           },
           "id": 1
       }

Atualizar item do agente HTTP

Ative a captura de valor do item.

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "item.atualização",
           "parâmetros": {
               "itemid": "23856",
               "allow_traps": "1"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "items": [
                   "23856"
               ]
           },
           "id": 1
       }

Atualizando um item com pré-processamento

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

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "item.atualização",
           "parâmetros": {
               "itemid": "23856",
               "pré-processando": [
                   {
                       "tipo": "13",
                       "params": "\n100",
                       "error_handler": "1",
                       "error_handler_params": ""
                   }
               ]
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "items": [
                   "23856"
               ]
           },
           "id": 1
       }

Atualizando um item de script

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

Solicitação:

{
           "jsonrpc": "2.0",
           "método": "item.atualização",
           "parâmetros": {
               "itemid": "23865",
               "parâmetros": [],
               "script": "Zabbix.Log(3, 'Teste de log');\nreturn 1;"
           },
           "auth": "700ca65537074ec963db7efabda78259",
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "resultado": {
               "items": [
                   "23865"
               ]
           },
           "id": 1
       }

Fonte

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