You are viewing documentation for the development version, it may be incomplete.
Join our translation project and help translate Zabbix documentation into your native language.

itemprototype.update

Beschrijving

object itemprototype.update(object/array itemPrototypes)

Deze methode maakt het mogelijk om bestaande itemprototypes bij te werken.

Deze methode is alleen beschikbaar voor gebruikerstypes Admin en Superadmin. Rechten om de methode aan te roepen kunnen worden ingetrokken in de instellingen van gebruikersrollen. Zie Gebruikersrollen voor meer informatie.

Parameters

(object/array) Item prototype-eigenschappen die moeten worden bijgewerkt.

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

Naast de standaard item prototype-eigenschappen accepteert de methode de volgende parameters.

Parameter Type Beschrijving
preprocessing array Item prototype voorverwerking opties om de huidige voorverwerkingsopties te vervangen.

Parametergedrag:
- alleen lezen voor geërfde objecten
tags array Item prototype tags.

Retourwaarden

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

Voorbeelden

Het wijzigen van de interface van een item prototype

Wijzig de hostinterface die zal worden gebruikt door ontdekte items.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "27428",
               "interfaceid": "132"
           },
           "id": 1
       }

Antwoord:

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

Bijwerken afhankelijk item prototype

Werk het afhankelijk item prototype bij met een nieuw ID voor het hoofditem prototype. Alleen afhankelijkheden op dezelfde host (sjabloon/ontdekkingsregel) zijn toegestaan, daarom moeten het hoofditem en het afhankelijk item dezelfde host-id en regel-id hebben.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "master_itemid": "25570",
               "itemid": "189030"
           },
           "id": 1
       }

Antwoord:

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

Update HTTP-agent item prototype

Wijzig de queryvelden en verwijder alle aangepaste headers.

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "28305",
               "query_fields": [
                   {
                       "random": "qwertyuiopasdfghjklzxcvbnm"
                   }
               ],
               "headers": []
           },
           "id": 1
       }

Antwoord:

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

Bijwerken van item voorverwerkingsinstellingen

Werk een item prototype bij met de item voorverwerkingsregel "Aangepaste vermenigvuldiger".

Aanvraag:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.update",
           "params": {
               "itemid": "44211",
               "preprocessing": [
                   {
                       "type": 1,
                       "params": "4",
                       "error_handler": 2,
                       "error_handler_params": "5"
                   }
               ]
           },
           "id": 1
       }

Antwoord:

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

Bijwerken van een script-item prototype

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

Aanvraag:

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

Antwoord:

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

Bron

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