Documentation
Table of Contents
פריט.עדכון
תיאור
object item.update(object/array items)
שיטה זו מאפשרת לעדכן פריטים קיימים.
לא ניתן לעדכן פריטי אינטרנט דרך ה-API של Zabbix.
שיטה זו זמינה רק ל-Admin ו-Super Admin סוגי משתמשים. ניתן לבטל הרשאות לקרוא לשיטה בתפקיד משתמש הגדרות. ראה משתמש תפקידים למידע נוסף.
פרמטרים
(אובייקט/מערך) מאפייני פריט שיש לעדכן.
יש להגדיר את המאפיין 'itemid' עבור כל פריט, כל השאר נכסים הם אופציונליים. רק המאפיינים שעברו יעודכנו, כולם אחרים יישארו ללא שינוי.
בנוסף למאפייני פריט סטנדרטיים, השיטה מקבל את הפרמטרים הבאים.
| פרמטר | סוג | תיאור |
|---|---|---|
| preprocessing | מערך | עיבוד מקדים של פריט אפשרויות להחלפת אפשרויות העיבוד המקדים הנוכחיות. |
| tags | מערך | פריט tags. |
החזר ערכים
(object) מחזירה אובייקט המכיל את המזהים של הפריטים המעודכנים תחת הנכס itemids.
דוגמאות
הפעלת פריט
אפשר פריט, כלומר, הגדר את הסטטוס שלו ל-"0".
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "10092",
"סטטוס": 0
},
"auth": "700ca65537074ec963db7efabda78259",
"מזהה": 1
}תְגוּבָה:
עדכן פריט תלוי
עדכן את שם הפריט התלוי ומזהה הפריט הראשי. רק תלות באותו מארח מותרים, לכן פריט מאסטר ופריט תלוי צריך להיות זהה hostid.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"name": "שם פריט תלוי מעודכן",
"master_itemid": "25562",
"itemid": "189019"
},
"auth": "700ca65537074ec963db7efabda78259",
"מזהה": 1
}תְגוּבָה:
עדכן פריט סוכן HTTP
אפשר השמנת ערך פריט.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"allow_traps": 1
},
"auth": "700ca65537074ec963db7efabda78259",
"מזהה": 1
}תְגוּבָה:
עדכון פריט עם עיבוד מקדים
עדכן פריט עם כלל עיבוד מוקדם של פריט "בטווח".
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23856",
"עיבוד מקדים": [
{
"סוג": 13,
"params": "\n100",
"error_handler": 1,
"error_handler_params": ""
}
]
},
"auth": "700ca65537074ec963db7efabda78259",
"מזהה": 1
}תְגוּבָה:
עדכון פריט סקריפט
עדכן פריט סקריפט בסקריפט אחר והסר פרמטרים מיותרים ששימשו את הסקריפט הקודם.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.update",
"params": {
"itemid": "23865",
"פרמטרים": [],
"script": "Zabbix.Log(3, 'Log test');\nreturn 1;"
},
"auth": "700ca65537074ec963db7efabda78259",
"מזהה": 1
}תְגוּבָה:
מקור
CItem::update() בתוך ui/include/classes/api/services/CItem.php.