מארח.עדכון

תיאור

object host.update(object/array hosts)

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

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

פרמטרים

(אובייקט/מערך) יש לעדכן מאפייני מארח.

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

עם זאת, שים לב שעדכון השם הטכני של המארח יתעדכן גם הוא השם הגלוי של המארח (אם לא ניתן או ריק) לפי הטכני של המארח ערך שם.

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

פרמטר סוג תיאור
groups object/array מארח קבוצות כדי להחליף את קבוצות המארחים הנוכחיות שהמארח שייך אליהן.

לקבוצות המארחות חייבות להיות 'groupid' מאפיין מוגדר. כל הקבוצות המארחות שאינן רשומות בבקשה יבוטלו.| |interfaces|object/array|מארח [ממשקים](/manual/api/reference/hostinterface/object) כדי להחליף את ממשקי המארח הנוכחיים.

כל הממשקים שאינם רשומים בבקשה יוסרו.| |tags|object/array|מארח [tags](/manual/api/reference/host/object#host_tag) כדי להחליף את תגי המארח הנוכחיים.

כל התגים שאינם רשומים בבקשה יוסרו .| |inventory|object|מארח [מלאי](/manual/api/reference/host/object#host_inventory).| |macros|object/array|[פקודות מאקרו משתמש](/manual/api/reference/usermacro/object) להחלפת פקודות המאקרו הנוכחיות של המשתמש.

כל פקודות המאקרו שאינן רשומות בבקשה יוסרו.| |templates|object/array|[Templates](/manual/api/reference/template/object) כדי להחליף את התבניות המקושרות כעת. כל התבניות שאינן רשומות בבקשה יבוטלו רק.

התבניות חייבות להיות מוגדרות המאפיין 'templateid'.| |templates\_clear|object/array|[Templates](/manual/api/reference/template/object) כדי לבטל את הקישור ולנקות מהמארח.

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

בניגוד לחזית ה-Zabix, כאשר 'שם' (גלוי שם מארח) זהה ל-'מארח' (שם מארח טכני), מעדכן את 'מארח' דרך API לא יעדכן אוטומטית את 'שם'. שני הנכסים צריכים להיות מעודכן באופן מפורש.

החזר ערכים

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

דוגמאות

הפעלת מארח

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
                "hostid": "10126",
                "סטטוס": 0
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

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

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
                "hostid": "10126",
                "נקה": [
                    {
                        "templateid": "10124"
                    },
                    {
                        "templateid": "10125"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

עדכון פקודות מאקרו מארח

החלף את כל פקודות המאקרו המארח בשתי חדשות.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
                "hostid": "10126",
                "מאקרו": [
                    {
                        "macro": "{$PASS}",
                        "value": "סיסמה"
                    },
                    {
                        "macro": "{$DISC}",
                        "value": "sda",
                        "description": "תיאור מעודכן"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

עדכון מלאי המארח

שנה מצב מלאי והוסף מיקום

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
                "hostid": "10387",
                "מצב_מלאי": 0,
                "מלאי": {
                    "location": "לטביה, ריגה"
                }
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

עדכון תגיות מארח

החלף את כל תגי המארח בתגיות חדשות.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.update",
            "params": {
                "hostid": "10387",
                "תגים": {
                    "tag": "OS",
                    "value": "RHEL 7"
                }
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

Updating discovered host macros

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

Request:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10387",
               "macros": {
                   "hostmacroid": "5541",
                   "value": "new-value",
                   "automatic": "0"
               }
           },
           "id": 1
       }

Response:

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

Updating host encryption

Update the host "10590" to use PSK encryption only for connections from host to Zabbix server, and change the PSK identity and PSK key. Note that the host has to be pre-configured to use PSK.

Request:

{
           "jsonrpc": "2.0",
           "method": "host.update",
           "params": {
               "hostid": "10590",
               "tls_connect": 1,
               "tls_accept": 2,
               "tls_psk_identity": "PSK 002",
               "tls_psk": "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9"
           },
           "id": 1
       }

Response:

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

ראה גם

מקור

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