Table of Contents
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:
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:
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:
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:
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:
Bron
CItem::update() in ui/include/classes/api/services/CItem.php.