This is a translation of the original English documentation page. Help us make it better.

פריט.יצירה

תיאור

object item.create(object/array items)

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

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

שיטה זו זמינה רק ל-Admin ו-Super Admin סוגי משתמשים. ניתן לבטל הרשאות לקרוא לשיטה בתפקיד משתמש הגדרות. ראה משתמש תפקידים למידע נוסף.

פרמטרים

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

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

פרמטר סוג תיאור
preprocessing מערך פריט עיבוד מראש אפשרויות.
tags מערך פריט tags.

החזר ערכים

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

דוגמאות

יצירת פריט

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

בַּקָשָׁה:

{
            "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
       }

תְגוּבָה:

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

יצירת פריט מלאי מארח

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

בַּקָשָׁה:

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

תְגוּבָה:

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

יצירת פריט עם עיבוד מקדים

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

בַּקָשָׁה:

{
            "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
       }

תְגוּבָה:

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

יצירת פריט תלוי

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

בַּקָשָׁה:

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

תְגוּבָה:

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

צור פריט סוכן HTTP

צור פריט שיטת בקשת POST עם עיבוד מקדים של תגובת 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
       }

תְגוּבָה:

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

צור פריט סקריפט

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

בַּקָשָׁה:

{
            "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
       }

תְגוּבָה:

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

מקור

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