hostgroup.massupdate

תיאור

object hostgroup.massupdate(אובייקט פרמטרים)

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

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

פרמטרים

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

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

לקבוצות המארחות חייב להיות מוגדר המאפיין groupid.
מארחים
(נדרש)
object/array מארחים להחלפת המארחים הנוכחיים בקבוצות המארחות הנתונות.
כל המארחים האחרים, מלבד אלו שהוזכרו, לא ייכללו בקבוצות המארחות.<br >מארחים שהתגלו לא יושפעו.

על המארחים להיות מוגדר המאפיין hostid.
תבניות
(חובה)
object/array תבניות להחלפת התבניות הנוכחיות בקבוצות המארחות הנתונות.
כל שאר התבניות, מלבד אלו שהוזכרו, לא ייכללו בקבוצות המארחות.<br >
התבניות חייבות להיות מוגדרות המאפיין 'templateid'.

החזר ערכים

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

דוגמאות

החלפת מארחים ותבניות בקבוצה מארחת

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "hostgroup.massupdate",
            "params": {
                "קבוצות": [
                    {
                        "groupid": "6"
                    }
                ],
                "מארחים": [
                    {
                        "hostid": "30050"
                    }
                ],
                "תבניות": []
            },
            "auth": "f223adf833b2bf2ff38574a67bba6372",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": {
                "קבוצות": [
                    "6",
                ]
            },
            "מזהה": 1
       }

מידע נוסף

מקור

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