host.massadd

תיאור

object host.massadd(אובייקט פרמטרים)

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

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

פרמטרים

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

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

פרמטר סוג תיאור
מארחים
(חובה)
object/array מארחים שיש לעדכן.

על המארחים להיות מוגדר המאפיין hostid.
groups object/array קבוצות מארחות להוספה למארחים הנתונים.

לקבוצות המארחות חייב להיות מוגדר המאפיין groupid.
interfaces object/array ממשקי מארח שייווצרו עבור המארחים הנתונים.
macros object/array פקודות מאקרו משתמש שייווצרו עבור המארחים הנתונים.
templates object/array תבניות לקישור למארחים הנתונים.

תבניות חייבות להיות מוגדרות המאפיין 'templateid'.

החזר ערכים

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

דוגמאות

הוספת פקודות מאקרו

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.massadd",
            "params": {
                "מארחים": [
                    {
                        "hostid": "10160"
                    },
                    {
                        "hostid": "10167"
                    }
                ],
                "מאקרו": [
                    {
                        "macro": "{$TEST1}",
                        "value": "MACROTEST1"
                    },
                    {
                        "macro": "{$TEST2}",
                        "value": "MACROTEST2",
                        "description": "תיאור הבדיקה"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "hostids": [
                    "10160",
                    "10167"
                ]
            },
            "מזהה": 1
       }

ראה גם

מקור

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