item.update

Beschrijving

object item.update(object/array-items)

Met deze methode kunnen bestaande items worden bijgewerkt.

Webitems kunnen niet worden bijgewerkt via de Zabbix API.

Deze methode is alleen beschikbaar voor Admin en Super admin gebruikers typen. Machtigingen om de methode aan te roepen kunnen worden ingetrokken in de gebruikersrol instellingen. Zie Gebruiker rollen voor meer informatie.

Parameters

(object/array) Itemeigenschappen die moeten worden bijgewerkt.

De eigenschap itemid moet worden gedefinieerd voor elk item, alle andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden bijgewerkt, allemaal andere blijven ongewijzigd.

Naast de standaard itemeigenschappen, is de methode accepteert de volgende parameters.

Parameter Type Beschrijving
preprocessing array Item preprocessing opties om de huidige preprocessing opties te vervangen.
tags array Item tags.

Retourwaarden

(object) Retourneert een object dat de ID's van de bijgewerkte items bevat onder de eigenschap 'itemids'.

Voorbeelden

Een item inschakelen

Schakel een item in, dat wil zeggen, stel de status in op "0".

Verzoek:

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

Antwoord:

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

Update afhankelijk item

Werk de naam van het afhankelijke item en de ID van het masteritem bij. Alleen afhankelijkheden van hetzelfde host zijn toegestaan, daarom moeten Master en Dependent item hetzelfde hebben gastheer.

Verzoek:

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

Antwoord:

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

HTTP-agentitem bijwerken

Schakel itemwaarde-trapping in.

Verzoek:

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

Antwoord:

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

Een item bijwerken met voorbewerking

Werk een artikel bij met de artikel voorverwerking regel "Binnen bereik".

Verzoek:

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

Antwoord:

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

Een scriptitem bijwerken

Werk een scriptitem bij met een ander script en verwijder onnodige parameters die door het vorige script werden gebruikt.

Verzoek:

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

Antwoord:

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

Bron

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