host.massremove

תיאור

object host.massremove(object parameters)

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

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

פרמטרים

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

פרמטר	סוג	תיאור
מארחים (נדרש)	מחרוזת/מערך	מזהים של המארחים שיש לעדכן.
groupids	string/array	קבוצות מארחות להסרת המארחים הנתונים.
interfaces	object/array	ממשקי מארח להסרה מהמארחים הנתונים. לאובייקט ממשק המארח חייבים להיות מוגדרים המאפיינים `ip`, `dns` ו-`port`.
macros	string/array	פקודות מאקרו של משתמש למחיקה מהמארחים הנתונים.
templateids	string/array	תבניות לביטול הקישור מהמארחים הנתונים.
templateids_clear	string/array	תבניות לביטול קישור וניקוי מהמארחים הנתונים.

החזר ערכים

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

דוגמאות

ביטול קישור תבניות

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.massremove",
            "params": {
                "hostids": ["69665", "69666"],
                "templateids_clear": "325"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

ראה גם

מקור

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

Documentation