Sidebar

Zabbix Summit 2022
View presentations

itemprototype.update

Description

object itemprototype.update(object/array itemPrototypes)

Cette méthode permet de mettre à jour des prototypes d’éléments existants.

Paramètres

(object/array) Propriétés du prototype d'élément à mettre à jour.

La propriété itemid doit être définie pour chaque prototype d'élément, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.

En plus des propriétés de l'objet prototype d'élément standard, la méthode accepte les paramètres suivants.

Parameter Type Description
applications array ID des applications en remplacement des applications actuelles.
applicationPrototypes array Noms des prototypes d'application en remplacement des prototypes d'application actuels.
preprocessing array Options de pré-traitement du prototype d’élément en remplacement des options de pré-traitement actuelles.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des prototypes d'élément mis à jour sous la propriété itemids.

Exemples

Modification de l'interface d'un prototype d'élément

Modifier l'interface hôte qui sera utilisée par les éléments découverts.

Requête :

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

Réponse :

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

Mise à jour d'un prototype d'élément dépendant

Mettre à jour le prototype d'élément dépendant avec le nouvel ID de prototype d'élément maître. Seules les dépendances sur le même hôte (modèle/règle de découverte) sont autorisées. Par conséquent, les éléments maîtres et dépendants doivent avoir les mêmes hostid et ruleid.

Requête :

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

Réponse :

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

Mise à jour d'un prototype d'élément d'agent HTTP

Modifier les champs de requête et supprimer tous les en-têtes personnalisés.

Requête :

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

Réponse :

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

Source

CItemPrototype::update() dans frontends/php/include/classes/api/services/CItemPrototype.php.