[comment]: # translation:outdated

[comment]: # ({959fe29c-959fe29c})
# פריט.יצירה

[comment]: # ({/959fe29c-959fe29c})

[comment]: # ({e3078f54-e3078f54})
### תיאור

`object item.create(object/array items)`

שיטה זו מאפשרת ליצור פריטים חדשים.

::: noteclassic
לא ניתן ליצור פריטי אינטרנט דרך ה-API של Zabbix.
:::

::: noteclassic
שיטה זו זמינה רק ל-*Admin* ו-*Super Admin*
סוגי משתמשים. ניתן לבטל הרשאות לקרוא לשיטה בתפקיד משתמש
הגדרות. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/e3078f54-e3078f54})

[comment]: # ({f82ccd43-777e8bec})
### פרמטרים

`(אובייקט/מערך)` פריטים ליצירה.

בנוסף ל[מאפייני פריט סטנדרטיים](object#host), השיטה
מקבל את הפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|preprocessing|מערך|פריט [עיבוד מראש](/manual/api/reference/item/object#item_preprocessing) אפשרויות.|
|tags|מערך|פריט [tags.](/manual/api/reference/item/object#item_tag)|

[comment]: # ({/f82ccd43-777e8bec})

[comment]: # ({632959fe-632959fe})
### החזר ערכים

`(object)` מחזירה אובייקט המכיל את המזהים של הפריטים שנוצרו
תחת הנכס `itemids`. סדר המזהים המוחזרים תואם את
סדר הפריטים שעברו.

[comment]: # ({/632959fe-632959fe})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({e504af22-6ffb1f45})
#### יצירת פריט

צור פריט סוכן מספרי של Zabbix עם 2 תגי פריט כדי לפקח על שטח דיסק פנוי במארח עם מזהה "30074".

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.create",
     "params": {
         "name": "שטח דיסק פנוי ב-/home/joe/",
         "key_": "vfs.fs.size[/home/joe/,free]",
         "hostid": "30074",
         "סוג": 0,
         "ערך_סוג": 3,
         "interfaceid": "30084",
         "תגים": [
             {
                 "tag": "שימוש בדיסק"
             },
             {
                 "tag": "ציוד",
                 "value": "תחנת עבודה"
             }
         ],
         "delay": "30s"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemids": [
             "24758"
         ]
     },
     "מזהה": 1
}
```

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

[comment]: # ({251fe7f0-0f29886e})
#### יצירת פריט מלאי מארח

צור פריט סוכן של Zabbix כדי לאכלס את שדה המלאי "OS" של המארח.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.create",
     "params": {
         "name": "uname",
         "key_": "system.uname",
         "hostid": "30021",
         "סוג": 0,
         "interfaceid": "30007",
         "סוג_ערך": 1,
         "delay": "10s",
         "קישור_מלאי": 5
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemids": [
             "24759"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/251fe7f0-0f29886e})

[comment]: # ({3461b9b0-f45b1a9a})
#### יצירת פריט עם עיבוד מקדים

צור פריט באמצעות מכפיל מותאם אישית.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.create",
     "params": {
         "name": "זמן פעילות של המכשיר",
         "key_": "sysUpTime",
         "hostid": "11312",
         "סוג": 4,
         "snmp_oid": "SNMPv2-MIB::sysUpTime.0",
         "סוג_ערך": 1,
         "delay": "שנות ה-60",
         "יחידות": "זמן פעולה",
         "interfaceid": "1156",
         "עיבוד מקדים": [
             {
                 "סוג 1,
                 "params": "0.01",
                 "error_handler": 1,
                 "error_handler_params": ""
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemids": [
             "44210"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/3461b9b0-f45b1a9a})

[comment]: # ({e9a67dd6-6a32a64f})
#### יצירת פריט תלוי

צור פריט תלוי עבור פריט המאסטר עם מזהה 24759. בלבד
מותרות תלות באותו מארח, לכן מאסטר וה-
לפריט תלוי צריך להיות אותו hosttid.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.create",
     "params": {
       "hostid": "30074",
       "name": "פריט בדיקה תלוי",
       "key_": "dependent.item",
       "סוג": 18,
       "master_itemid": "24759",
       "סוג_ערך": 2
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemids": [
             "44211"
         ]
     },
     "מזהה": 1
}
```

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

[comment]: # ({7cb04e76-70eb9eae})
#### צור פריט סוכן HTTP

צור פריט שיטת בקשת POST עם עיבוד מקדים של תגובת JSON.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.create",
     "params": {
         "url": "http://127.0.0.1/http.php",
         "query_fields": [
             {
                 "mode": "json"
             },
             {
                 "min": "10"
             },
             {
                 "max": "100"
             }
         ],
         "interfaceid": "1",
         "סוג": 19,
         "hostid": "10254",
         "delay": "5s",
         "key_": "json",
         "name": "דוגמה לסוכן HTTP JSON",
         "ערך_סוג": 0,
         "output_format": 1,
         "עיבוד מקדים": [
             {
                 "סוג": 12,
                 "params": "$.random",
                 "error_handler": 0,
                 "error_handler_params": ""
             }
         ]
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 2
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemids": [
             "23865"
         ]
     },
     "מזהה": 3
}
```

[comment]: # ({/7cb04e76-70eb9eae})

[comment]: # ({bf510108-313c9999})
#### צור פריט סקריפט

צור איסוף נתונים פשוט באמצעות פריט סקריפט.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "item.create",
     "params": {
         "name": "דוגמה לסקריפט",
         "key_": "custom.script.item",
         "hostid": "12345",
         "סוג": 21,
         "ערך_סוג": 4,
         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",
         "פרמטרים": [
             {
                 "name": "מארח",
                 "value": "{HOST.CONN}"
             }
         ],
         "timeout": "6 שניות",
         "delay": "30s"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 2
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "itemids": [
             "23865"
         ]
     },
     "מזהה": 3
}
```

[comment]: # ({/bf510108-313c9999})

[comment]: # ({ecb97b1d-ecb97b1d})
### מקור

CItem::create()‎ בתוך *ui/include/classes/api/services/CItem.php*.

[comment]: # ({/ecb97b1d-ecb97b1d})