מפה.צור

תיאור

object map.create(object/array maps)

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

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

פרמטרים

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

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

פרמטר סוג תיאור
links מערך מפה קישורים שתיווצר על המפה.
selements מערך מפה אלמנטים שתיווצר במפה.
urls array מפה כתובות אתרים שתיווצר על המפה.
users array מפה שיתופי משתמש שייווצרו על המפה.
userGroups מערך מפה שיתופים של קבוצת משתמשים שייווצרו במפה.
shapes מערך מפה צורות שתיווצר על המפה.
lines array מפה שורות שתיווצר על המפה.

כדי ליצור קישורי מפה תצטרך להגדיר רכיב מפה selementid לערך שרירותי ולאחר מכן השתמש בערך זה כדי להתייחס אלמנט זה במאפיינים 'selementid1' או 'selementid2'. כאשר האלמנט נוצר, ערך זה יוחלף ב- מזהה נכון שנוצר על ידי Zabbix. לִרְאוֹת דוגמה.

החזר ערכים

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

דוגמאות

צור מפה ריקה

צור מפה ללא אלמנטים.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "map.create",
            "params": {
                "name": "מפה",
                "רוחב": 600,
                "גובה": 600
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

צור מפת מארח

צור מפה עם שני אלמנטים מארח וקישור ביניהם. שימו לב ל שימוש בערכי "selementid1" ו-"selementid2" זמניים בקישור המפה אובייקט להתייחס לרכיבי מפה.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "map.create",
            "params": {
                "name": "מפת מארח",
                "רוחב": 600,
                "גובה": 600,
                "אלמנטים": [
                    {
                        "selementid": "1",
                        "אלמנטים": [
                            {"hostid": "1033"}
                        ],
                        "elementtype": 0,
                        "iconid_off": "2"
                    },
       
                    {
                        "selementid": "2",
                        "אלמנטים": [
                            {"hostid": "1037"}
                        ],
                        "elementtype": 0,
                        "iconid_off": "2"
                    }
                ],
                "קישורים": [
                    {
                        "selementid1": "1",
                        "selementid2": "2"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

צור מפת טריגר

צור מפה עם אלמנט טריגר, שמכיל שני טריגרים.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "map.create",
            "params": {
                "name": "מפת טריגר",
                "רוחב": 600,
                "גובה": 600,
                "אלמנטים": [
                    {
                        "אלמנטים": [
                            {"triggerid": "12345"},
                            {"triggerid": "67890"}
                        ],
                        "elementtype": 2,
                        "iconid_off": "2"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

שיתוף מפה

צור מפה עם שני סוגי שיתוף (משתמש וקבוצת משתמשים).

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "map.create",
            "params": {
                "name": "שיתוף מפה",
                "רוחב": 600,
                "גובה": 600,
                "משתמשים": [
                    {
                        "userid": "4",
                        "permission": "3"
                    }
                ],
                "קבוצות משתמש": [
                    {
                        "usrgrpid": "7",
                        "permission": "2"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

צורות מפה

צור מפה עם כותרת שם המפה.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "map.create",
            "params": {
                "name": "מפת מארח",
                "רוחב": 600,
                "גובה": 600,
                "צורות": [
                    {
                        "סוג": 0,
                        "x": 0,
                        "y": 0,
                        "רוחב": 600,
                        "גובה": 11,
                        "text": "{MAP.NAME}"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

קווי מפה

צור קו מפה.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "map.create",
            "params": {
                "name": "מיפוי קווי API",
                "רוחב": 500,
                "גובה": 500,
                "שורות": [
                    {
                        "x1": 30,
                        "y1": 10,
                        "x2": 100,
                        "y2": 50,
                        "סוג_שורה": 1,
                        "רוחב_קו": 10,
                        "line_color": "009900"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

ראה גם

מקור

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