Documentation
6.0
עִברִית (beta)
Table of Contents
פריט.קבל
תיאור
integer/array item.get(object parameters)
השיטה מאפשרת לשלוף פריטים לפי הפרמטרים הנתונים.
שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.
תיאור
integer/array item.get(object parameters)
השיטה מאפשרת לשלוף פריטים לפי הפרמטרים הנתונים.
שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.
החזר ערכים
(מספר שלם/מערך) מחזיר אחד:
- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר
countOutputנעשה שימוש.
דוגמאות
החזר ערכים
(מספר שלם/מערך) מחזיר אחד:
- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר
countOutputנעשה שימוש.
מציאת פריטים תלויים לפי מפתח
אחזר את כל הפריטים התלויים מהמארח עם המזהה "10116" עם המילה "apache" במפתח.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.get",
"params": {
"output": "להרחיב",
"hostids": "10116",
"לחפש": {
"key_": "apache"
},
"מסנן": {
"סוג": 18
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}Copy
✔ Copied
תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": [
{
"itemid": "25550",
"type": "18",
"snmp_oid": "",
"hostid": "10116",
"name": "ימים",
"key_": "apache.status.uptime.days",
"delay": "0",
"history": "90d",
"trends": "365d",
"status": "0",
"value_type": "3",
"trapper_hosts": "",
"יחידות": "",
"logtimefmt": "",
"templateid": "0",
"valuemapid": "0",
"params": "",
"ipmi_sensor": "",
"authtype": "0",
"שם משתמש": "",
"סיסמה": "",
"מפתח ציבורי": "",
"מפתח פרטי": "",
"flags": "0",
"interfaceid": "0",
"תיאור": "",
"inventory_link": "0",
"evaltype": "0",
"jmx_endpoint": "",
"master_itemid": "25545",
"timeout": "3 שניות",
"url": "",
"query_fields": [],
"פוסטים": "",
"status_codes": "200",
"follow_redirects": "1",
"post_type": "0",
"http_proxy": "",
"כותרות": [],
"retrieve_mode": "0",
"request_method": "0",
"output_format": "0",
"ssl_cert_file": "",
"ssl_key_file": "",
"ssl_key_password": "",
"verify_peer": "0",
"verify_host": "0",
"allow_traps": "0",
"uuid": "",
"state": "0",
"error": "",
"פרמטרים": [],
"lastclock": "0",
"lastns": "0",
"lastvalue": "0",
"prevvalue": "0"
},
{
"itemid": "25555",
"type": "18",
"snmp_oid": "",
"hostid": "10116",
"name": "שעות",
"key_": "apache.status.uptime.hours",
"delay": "0",
"history": "90d",
"trends": "365d",
"status": "0",
"value_type": "3",
"trapper_hosts": "",
"יחידות": "",
"logtimefmt": "",
"templateid": "0",
"valuemapid": "0",
"params": "",
"ipmi_sensor": "",
"authtype": "0",
"שם משתמש": "",
"סיסמה": "",
"מפתח ציבורי": "",
"מפתח פרטי": "",
"flags": "0",
"interfaceid": "0",
"תיאור": "",
"inventory_link": "0",
"evaltype": "0",
"jmx_endpoint": "",
"master_itemid": "25545",
"timeout": "3 שניות",
"url": "",
"query_fields": [],
"פוסטים": "",
"status_codes": "200",
"follow_redirects": "1",
"post_type": "0",
"http_proxy": "",
"כותרות": [],
"retrieve_mode": "0",
"request_method": "0",
"output_format": "0",
"ssl_cert_file": "",
"ssl_key_file": "",
"ssl_key_password": "",
"verify_peer": "0",
"verify_host": "0",
"allow_traps": "0",
"uuid": "",
"state": "0",
"error": "",
"פרמטרים": [],
"lastclock": "0",
"lastns": "0",
"lastvalue": "0",
"prevvalue": "0"
}
],
"מזהה": 1
}Copy
✔ Copied
מצא פריט סוכן HTTP
מצא פריט סוכן HTTP עם סוג גוף הפוסט XML עבור מזהה מארח ספציפי.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.get",
"params": {
"hostids": "10255",
"מסנן": {
"סוג": 19,
"post_type": 3
}
},
"מזהה": 3,
"auth": "d678e0b85688ce578ff061bd29a20d3b"
}Copy
✔ Copied
תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": [
{
"itemid": "28252",
"type": "19",
"snmp_oid": "",
"hostid": "10255",
"name": "פריט תבנית",
"key_": "ti",
"delay": "30s",
"history": "90d",
"trends": "365d",
"status": "0",
"value_type": "3",
"trapper_hosts": "",
"יחידות": "",
"logtimefmt": "",
"templateid": "0",
"valuemapid": "0",
"params": "",
"ipmi_sensor": "",
"authtype": "0",
"שם משתמש": "",
"סיסמה": "",
"מפתח ציבורי": "",
"מפתח פרטי": "",
"flags": "0",
"interfaceid": "0",
"תיאור": "",
"inventory_link": "0",
"evaltype": "0",
"jmx_endpoint": "",
"master_itemid": "0",
"timeout": "3 שניות",
"url": "localhost",
"query_fields": [
{
"mode": "xml"
}
],
"posts": "<body>\r\n<![CDATA[{$MACRO}<foo></bar>]]>\r\n</body>",
"status_codes": "200",
"follow_redirects": "0",
"post_type": "3",
"http_proxy": "",
"כותרות": [],
"retrieve_mode": "1",
"request_method": "3",
"output_format": "0",
"ssl_cert_file": "",
"ssl_key_file": "",
"ssl_key_password": "",
"verify_peer": "0",
"verify_host": "0",
"allow_traps": "0",
"uuid": "",
"state": "0",
"error": "",
"פרמטרים": [],
"lastclock": "0",
"lastns": "0",
"lastvalue": "",
"prevvalue": ""
}
],
"מזהה": 3
}Copy
✔ Copied
אחזור פריטים עם כללי עיבוד מקדים
אחזר את כל הפריטים וכללי העיבוד המקדים שלהם עבור מזהה מארח ספציפי.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "item.get",
"params": {
"output": ["itemid", "name", "key_"],
"selectPreprocessing": "להרחיב",
"hostids": "10254"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}Copy
✔ Copied
תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": {
"itemid": "23865",
"name": "דוגמה לסוכן HTTP JSON",
"key_": "json",
"עיבוד מקדים": [
{
"type": "12",
"params": "$.random",
"error_handler": "1",
"error_handler_params": ""
}
]
},
"מזהה": 1
}Copy
✔ Copied
מידע נוסף
מקור
CItem::get() בתוך ui/include/classes/api/services/CItem.php.