usermacro.update

תיאור

object usermacro.update(object/array hostMacros)

שיטה זו מאפשרת לעדכן פקודות מאקרו מארח קיימות.

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

פרמטרים

(object/array) מאפייני מאקרו מארח להיות מְעוּדכָּן.

יש להגדיר את המאפיין hostmacroid עבור כל מאקרו מארח, הכל נכסים אחרים הם אופציונליים. רק הנכסים שעברו יהיו עודכן, כל השאר יישארו ללא שינוי.

החזר ערכים

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

דוגמאות

שינוי הערך של מאקרו מארח

שנה את הערך של מאקרו מארח ל"ציבורי".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "usermacro.update",
            "params": {
                "hostmacroid": "1",
                "value": "ציבורי"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

Change macro value that was created by discovery rule

Convert discovery rule created "automatic" macro to "manual" and change its value to "new-value".

Request:

{
           "jsonrpc": "2.0",
           "method": "usermacro.update",
           "params": {
               "hostmacroid": "1",
               "value": "new-value",
               "automatic": "0"
           },
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "hostmacroids": [
                   "1"
               ]
           },
           "id": 1
       }

מקור

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

Documentation