[comment]: # translation:outdated

[comment]: # ({6bb9f60f-6bb9f60f})
# > עצם פריט

העצמים הבאים קשורים ישירות ל־API‏ `item`.

[comment]: # ({/6bb9f60f-6bb9f60f})

[comment]: # ({747a2371-385ac8b5})
#### אחזור פריטים עם כללי עיבוד מקדים

אחזר את כל הפריטים וכללי העיבוד המקדים שלהם עבור מזהה מארח ספציפי.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.get",
     "params": {
         "output": ["itemid", "name", "key_"],
         "selectPreprocessing": "להרחיב",
         "hostids": "10254"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemid": "23865",
         "name": "דוגמה לסוכן HTTP JSON",
         "key_": "json",
         "עיבוד מקדים": [
             {
                 "type": "12",
                 "params": "$.random",
                 "error_handler": "1",
                 "error_handler_params": ""
             }
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/747a2371-385ac8b5})

[comment]: # ({9f2431a0-c1b98afa})
### תג פריט

לאובייקט תג הפריט יש את המאפיינים הבאים.

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**תג**<br>(חובה)|מחרוזת|שם תג פריט.|
|value|string|ערך תג פריט.|

[comment]: # ({/9f2431a0-c1b98afa})

[comment]: # ({0d7042b9-2169bb78})
### עיבוד מקדים של פריט

לאובייקט העיבוד המקדים של הפריט יש את המאפיינים הבאים.

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**סוג**<br>(נדרש)|מספר שלם|סוג אפשרות העיבוד המקדים.<br><br>ערכים אפשריים:<br>1 - מכפיל מותאם אישית;<br>2 - חיתוך ימני;<br>3 - חיתוך שמאלי;<br>4 - חיתוך;<br>5 - התאמת ביטויים רגולריים;<br>6 - בוליאני לעשרוני;<br>7 - אוקטל עד עשרוני;<br>8 - הקסדצימלי לעשרוני;<br>9 - שינוי פשוט;<br>10 - שינוי בשנייה;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - בטווח;<br>14 - מתאים לביטוי רגולרי;<br>15 - לא תואם ביטוי רגולרי;<br>16 - בדוק אם יש שגיאה ב-JSON;<br>17 - בדוק אם יש שגיאה ב-XML;<br>18 - בדוק אם יש שגיאה באמצעות ביטוי רגולרי;<br>19 - מחק ללא שינוי;<br >20 - זרוק ללא שינוי עם פעימות לב;<br>21 - JavaScript;<br>22 - דפוס פרומתאוס;<br>23 - פרומתאוס ל-JSON;<br>24 - CSV ל-JSON;<br>25 - החלף;<br >26 - סימון לא נתמך;<br>27 - XML ל-JSON.|
|**פרמטרים**<br>(חובה)|מחרוזת|פרמטרים נוספים המשמשים אפשרות עיבוד מקדים. פרמטרים מרובים מופרדים על ידי תו LF (\\n).|
|**שגיאה\_מטפל**<br>(נדרש)|מספר שלם|סוג הפעולה המשמש במקרה של כשל בשלב העיבוד המקדים.<br><br>ערכים אפשריים:<br>0 - הודעת השגיאה מוגדרת על ידי שרת Zabbix;< br>1 - Discard value;<br>2 - הגדר ערך מותאם אישית;<br>3 - הגדר הודעת שגיאה מותאמת אישית.|
|**error\_handler\_params**<br>(נדרש)|string|פרמטרים של מטפל שגיאות. בשימוש עם `error_handler`.<br><br>חייב להיות ריק, אם `error_handler` הוא 0 או 1.<br>יכול להיות ריק אם, `error_handler` הוא 2.<br>לא יכול להיות ריק, אם `error_handler` הוא 3.|

הפרמטרים הבאים ומטפלי השגיאות נתמכים עבור כל אחד מהם
סוג עיבוד מקדים.

|סוג עיבוד מקדים|שם|פרמטר 1|פרמטר 2|פרמטר 3|מטפלי שגיאות נתמכים|
|----------------|----|--------|-----|- ----------|------------------------|
|1|מכפיל מותאם אישית|מספר^1,\ 6^|<|<|0, 1, 2, 3|
|2|חתוך ימני|רשימת תווים^2^|<|<|<|
|3|חיתוך שמאלי|רשימת תווים^2^|<|<|<|
|4|חתוך|רשימת התווים^2^|<|<|<|
|5|ביטוי רגולרי|דפוס^3^|פלט^2^|<|0, 1, 2, 3|
|6|בוליאנית לעשרונית|<|<|<|0, 1, 2, 3|
|7|אוקטאל עד עשרוני|<|<|<|0, 1, 2, 3|
|8|הקסדצימלי לעשרוני|<|<|<|0, 1, 2, 3|
|9|שינוי פשוט|<|<|<|0, 1, 2, 3|
|10|שינוי בשנייה|<|<|<|0, 1, 2, 3|
|11|XML XPath|נתיב^4^|<|<|0, 1, 2, 3|
|12|JSONPath|נתיב^4^|<|<|0, 1, 2, 3|
|13|בטווח|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3|
|14|תואם ביטוי רגולרי|דפוס^3^|<|<|0, 1, 2, 3|
|15|לא תואם לביטוי רגולרי|דפוס^3^|<|<|0, 1, 2, 3|
|16|בדוק אם יש שגיאה ב-JSON|path^4^|<|<|0, 1, 2, 3|
|17|בדוק אם יש שגיאה ב-XML|נתיב^4^|<|<|0, 1, 2, 3|
|18|בדוק אם יש שגיאה באמצעות ביטוי רגולרי|דפוס^3^|פלט^2^|<|0, 1, 2, 3|
|19|מחק ללא שינוי|<|<|<|<|
|20|הסר ללא שינוי עם פעימות לב|שניות^5,\ 6^|<|<|<|
|21|JavaScript|script^2^|<|<|<|
|22|דפוס פרומתאוס|דפוס^6,\ 7^|`ערך`, `תווית`, `פונקציה`|פלט^8,\ 9^|0, 1, 2, 3|
|23|פרומתאוס ל-JSON|דפוס^6,\ 7^|<|<|0, 1, 2, 3|
|24|CSV ל-JSON|תו^2^|תו^2^|0,1|0, 1, 2, 3|
|25|החלף|מחרוזת חיפוש^2^|החלפה^2^|<|<|
|26|סמן לא נתמך|<|<|<|1, 2, 3|
|27|XML ל-JSON|<|<|<|0, 1, 2, 3|

^1^ מספר שלם או נקודה צפה\
^2^ מחרוזת\
^3^ ביטוי רגולרי\
^4^ JSONPath או XML XPath\
^5^ מספר שלם חיובי (עם תמיכה בסיומת זמן, למשל 30s, 1m, 2h,
1ד)\
^6^ מאקרו משתמש\
^7^ דפוס פרומתאוס בעקבות התחביר:
`<שם המדד>{<שם התווית>="<ערך התווית>", ...} == <ערך>`. כל אחד
רכיב דפוס פרומתאוס (מדד, שם תווית, ערך תווית ומדד
value) יכול להיות מאקרו משתמש.\
^8^ פלט Prometheus בעקבות התחביר: `<שם התווית>` (יכול להיות מאקרו משתמש) אם `תווית` נבחרה כפרמטר השני.\
^9^ אחת מפונקציות הצבירה: `sum`, `min`, `max`, `avg`, `count` אם `function` נבחרה כפרמטר השני.

[comment]: # ({/0d7042b9-2169bb78})