מארח.עדכון מס

תיאור

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

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

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

פרמטרים

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

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

פרמטר	סוג	תיאור
מארחים (חובה)	object/array	hosts לעדכון. המארחים חייבים להיות בעלי ה-'hostid' מאפיין מוגדר.
groups	object/array	מארח קבוצות כדי להחליף את הקבוצות המארחות הנוכחיות שאליהן שייכים המארחים. לקבוצות המארחות חייבות להיות המאפיין `groupid` מוגדר.
interfaces	object/array	מארח ממשקים כדי להחליף את ממשקי המארח הנוכחיים במארחים הנתונים.
inventory	object	מארח inventory מאפיינים. לא ניתן לעדכן מצב מלאי מארח באמצעות הפרמטר `inventory`, השתמש במקום זאת ב-`inventory_mode`.
macros	object/array	פקודות מאקרו משתמש כדי להחליף את פקודות המאקרו הנוכחיות של המשתמש במארחים הנתונים.
templates	object/array	Templates כדי להחליף את התבניות המקושרות כעת במארחים הנתונים. התבניות חייבות להיות מוגדרות במאפיין `templateid`.
templates_clear	object/array	Templates כדי לבטל את הקישור ולנקות מהמארחים הנתונים. התבניות חייבות להגדיר את המאפיין 'templateid'.

החזר ערכים

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

דוגמאות

הפעלת מארחים מרובים

אפשר ניטור של שני מארחים, כלומר, הגדר את המצב שלהם ל-0.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.massupdate",
            "params": {
                "מארחים": [
                    {
                        "hostid": "69665"
                    },
                    {
                        "hostid": "69666"
                    }
                ],
                "סטטוס": 0
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

מידע נוסף

מקור

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

Documentation