Documentation
Table of Contents
item.update
Description
object item.update(object/array items)
Cette m¨¦thode permet de mettre ¨¤ jour les ¨¦l¨¦ments existants.
Les ¨¦l¨¦ments Web ne peuvent pas ¨ºtre mis ¨¤ jour via l'API Áú»¢¶Ä²©.
Cette m¨¦thode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la m¨¦thode peuvent ¨ºtre r¨¦voqu¨¦es dans les param¨¨tres de r?les utilisateur. Voir R?les Utilisateur pour plus d'informations.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
(object/array) Propri¨¦t¨¦s de l'¨¦l¨¦ment ¨¤ mettre ¨¤ jour.
La propri¨¦t¨¦ itemid doit ¨ºtre d¨¦finie pour chaque ¨¦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 d'¨¦l¨¦ment standard, la m¨¦thode accepte les param¨¨tres suivants.
| ±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð | Type | Description |
|---|---|---|
| preprocessing | array | Options de pr¨¦traitement de l'¨¦l¨¦ment ¨¤ remplacer dans les options de pr¨¦traitement actuelles. |
| tags | array | Tags de l'¨¦l¨¦ment. |
Valeurs retourn¨¦es
(object) Retourne un objet contenant les identifiants des ¨¦l¨¦ments mis ¨¤ jour sous la propri¨¦t¨¦ itemids.
Exemples
Activation d'un ¨¦l¨¦ment
Activez un ¨¦l¨¦ment, c'est-¨¤-dire d¨¦finissez son ¨¦tat sur "0".
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"status": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}R¨¦ponse :
Mettre ¨¤ jour l'¨¦l¨¦ment d¨¦pendant
Mettez ¨¤ jour le nom de l'¨¦l¨¦ment d¨¦pendant et l'ID de l'¨¦l¨¦ment principal. Seules les d¨¦pendances sur le m¨ºme h?te sont autoris¨¦es. Par cons¨¦quent, les ¨¦l¨¦ments ma?tre et d¨¦pendant doivent avoir le m¨ºme identifiant d'h?te.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "Dependent item updated name",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}R¨¦ponse :
Mettre ¨¤ jour l'¨¦l¨¦ment d'agent HTTP
Activez le trap pour la valeur de l'¨¦l¨¦ment.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}R¨¦ponse :
Mise ¨¤ jour d'un ¨¦l¨¦ment avec pr¨¦traitement
Mettre ¨¤ jour un ¨¦l¨¦ment avec la r¨¨gle de pr¨¦traitement d'¨¦l¨¦ment "In range".
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"preprocessing": [
{
"type": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}R¨¦ponse :
Mise ¨¤ jour d'un ¨¦l¨¦ment de script
Mettez ¨¤ jour un ¨¦l¨¦ment de script avec un script diff¨¦rent et supprimez les param¨¨tres inutiles qui ont ¨¦t¨¦ utilis¨¦s par le script pr¨¦c¨¦dent.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23865",
"parameters": [],
"script": "Áú»¢¶Ä²©.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"id": 1
}R¨¦ponse :
Source
CItem::update() dans ui/include/classes/api/services/CItem.php.