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.