itemprototype.update

Beschrijving

object itemprototype.update(object/array itemPrototypes)

Met deze methode kunnen bestaande prototypen van artikelen worden bijgewerkt.

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) Eigenschappen van prototype van item moeten worden bijgewerkt.

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

Aanvullend op het prototype standaarditem eigenschappen, accepteert de methode het volgende: parameters.

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

Retourwaarden

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

Voorbeelden

De interface van een prototype van een item wijzigen

Wijzig de hostinterface die wordt gebruikt door ontdekte items.

Verzoek:

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

Antwoord:

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

Update afhankelijk item prototype

Werk het prototype van het afhankelijk artikel bij met de nieuwe prototype-ID van het hoofdartikel. Enkel en alleen afhankelijkheden op dezelfde host (sjabloon/ontdekkingsregel) zijn toegestaan, daarom moeten Master en Dependent item dezelfde hostid en ruleid hebben.

Verzoek:

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

Antwoord:

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

Prototype van HTTP-agent item bijwerken

Wijzig query velden en verwijder alle aangepaste kopteksten.

Verzoek:

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

Antwoord:

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

Voorbewerkings opties voor items bijwerken

Een artikelprototype bijwerken met de regel voor voorverwerking van artikelen "Aangepast vermenigvuldiger".

Verzoek:

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

Antwoord:

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

Een prototype van een script item bijwerken

Een prototype van een script item bijwerken met een ander script en verwijderen onnodige parameters die door het vorige script werden gebruikt.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "itemprototype.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

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