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

itemprototype.create

תיאור

object itemprototype.create(object/array itemPrototypes)

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

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

פרמטרים

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

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

פרמטר סוג תיאור
ruleid
(נדרש)
מחרוזת מזהה של כלל LLD שאליו שייך הפריט.
preprocessing מערך אפשרויות אב-טיפוס preprocessing של פריט.
tags מערך אב-טיפוס של פריט תגים.

החזר ערכים

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

דוגמאות

יצירת אב טיפוס של פריט

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.create",
            "params": {
                "name": "שטח דיסק פנוי ב-{#FSNAME}",
                "key_": "vfs.fs.size[{#FSNAME},חינם]",
                "hostid": "10197",
                "ruleid": "27665",
                "סוג": 0,
                "ערך_סוג": 3,
                "interfaceid": "112",
                "delay": "30s"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }
Copy
✔ Copied

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "itemids": [
                    "27666"
                ]
            },
            "מזהה": 1
       }
Copy
✔ Copied

יצירת אב טיפוס של פריט עם עיבוד מקדים

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.create",
            "params": {
                "name": "תעבורת רשת נכנסת ב-{#IFNAME}",
                "key_": "net.if.in[{#IFNAME}]",
                "hostid": "10001",
                "ruleid": "27665",
                "סוג": 0,
                "ערך_סוג": 3,
                "delay": "שנות ה-60",
                "יחידות": "bps",
                "interfaceid": "1155",
                "עיבוד מקדים": [
                    {
                        "סוג": 10,
                        "params": "",
                        "error_handler": 0,
                        "error_handler_params": ""
                    },
                    {
                        "סוג 1,
                        "params": "8",
                        "error_handler": 2,
                        "error_handler_params": "10"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }
Copy
✔ Copied

תְגוּבָה:

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

יצירת אב טיפוס של פריט תלוי

צור אב טיפוס של פריט תלוי עבור אב טיפוס של פריט ראשי עם מזהה 44211. רק תלות באותו מארח (כלל תבנית/גילוי) מותרות, לכן פריט מאסטר ותלוי צריכים להיות בעלי אותו hostid ו- ruleid.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.create",
            "params": {
              "hostid": "10001",
              "ruleid": "27665",
              "name": "אב-טיפוס של פריט בדיקה תלוי",
              "key_": "dependent.prototype",
              "סוג": 18,
              "master_itemid": "44211",
              "סוג_ערך": 3
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }
Copy
✔ Copied

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "itemids": [
                    "44212"
                ]
            },
            "מזהה": 1
       }
Copy
✔ Copied

צור אב טיפוס של פריט סוכן HTTP

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.create",
            "params": {
                "type": "19",
                "hostid": "10254",
                "ruleid": "28256",
                "interfaceid": "2",
                "name": "דוגמה לאב-טיפוס של פריט API",
                "key_": "api_http_item",
                "ערך_סוג": 3,
                "url": "{$URL_PROTOTYPE}",
                "query_fields": [
                    {
                        "min": "10"
                    },
                    {
                        "max": "100"
                    }
                ],
                "headers": {
                    "X-Source": "API"
                },
                "עיכוב": "35"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }
Copy
✔ Copied

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "itemids": [
                    "28305"
                ]
            },
            "מזהה": 1
       }
Copy
✔ Copied

צור אב טיפוס של פריט סקריפט

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "itemprototype.create",
            "params": {
                "name": "דוגמה לסקריפט",
                "key_": "custom.script.itemprototype",
                "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
       }
Copy
✔ Copied

תְגוּבָה:

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

מקור

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.