Documentation
Table of Contents
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 :
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 :
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 :
Source
CItemPrototype::update() dans frontends/php/include/classes/api/services/CItemPrototype.php.