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 foram usados pelo script anterior.

Requisição:

{
    "jsonrpc": "2.0",
    "method": "item.update",
    "params": {
        "itemid": "23865",
        "parameters": [],
        "params": "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.