host.create

תיאור

object host.create(object/array hosts)

שיטה זו מאפשרת ליצור מארחים חדשים.

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

פרמטרים

(אובייקט/מערך) מארחים ליצירה.

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

פרמטר	סוג	תיאור
קבוצות (חובה)	object/array	מארח קבוצות כדי להוסיף את המארח אליו. לקבוצות המארחות חייבות להיות המאפיין 'קבוצתי' שהוגדר.
interfaces	object/array	ממשקים שייווצרו עבור המארח.
tags	object/array	מארח תגים.
templates	object/array	Templates לקישור למארח. על התבניות להיות מוגדר המאפיין 'templateid'.
macros	object/array	פקודות מאקרו משתמש שייווצרו עבור המארח.
inventory	object	מארח מלאי.

החזר ערכים

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

דוגמאות

יצירת מארח

צור מארח בשם "שרת לינוקס" עם ממשק IP ותגים, הוסף זה לקבוצה, קשר אליו תבנית והגדר את כתובות ה-MAC ב- מלאי המארח.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.create",
            "params": {
                "host": "שרת לינוקס",
                "ממשקים": [
                    {
                        "סוג 1,
                        "ראשי": 1,
                        "useip": 1,
                        "ip": "192.168.3.1",
                        "dns": "",
                        "port": "10050"
                    }
                ],
                "קבוצות": [
                    {
                        "groupid": "50"
                    }
                ],
                "תגים": [
                    {
                        "tag": "שם מארח",
                        "value": "שרת לינוקס"
                    }
                ],
                "תבניות": [
                    {
                        "templateid": "20045"
                    }
                ],
                "מאקרו": [
                    {
                        "macro": "{$USER_ID}",
                        "value": "123321"
                    },
                    {
                        "macro": "{$USER_LOCATION}",
                        "value": "0:0:0",
                        "description": "קואורדינטות של קווי רוחב, קו אורך וגובה"
                    }
                ],
                "מצב_מלאי": 0,
                "מלאי": {
                    "macaddress_a": "01234",
                    "macaddress_b": "56768"
                }
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

יצירת מארח עם ממשק SNMP

צור מארח בשם "מארח SNMP" עם ממשק SNMPv3 עם פרטים.

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "host.create",
            "params": {
                "host": "מארח SNMP",
                "ממשקים": [
                    {
                        "סוג": 2,
                        "ראשי": 1,
                        "useip": 1,
                        "ip": "127.0.0.1",
                        "dns": "",
                        "port": "161",
                        "פרטים": {
                            "גרסה": 3,
                            "כמות גדולה": 0,
                            "securityname": "mysecurityname",
                            "contextname": "",
                            "רמת אבטחה": 1
                        }
                    }
                ],
                "קבוצות": [
                    {
                        "groupid": "4"
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

Creating a host with PSK encryption

Create a host called "PSK host" with PSK encryption configured. Note that the host has to be pre-configured to use PSK.

Request:

{
           "jsonrpc": "2.0",
           "method": "host.create",
           "params": {
               "host": "PSK host",
               "interfaces": [
                   {
                       "type": 1,
                       "ip": "192.168.3.1",
                       "dns": "",
                       "port": "10050",
                       "useip": 1,
                       "main": 1
                   }
               ],
               "groups": [
                   {
                       "groupid": "2"
                   }
               ],
               "tls_accept": 2,
               "tls_connect": 2,
               "tls_psk_identity": "PSK 001",
               "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

ראה גם

מקור

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

Documentation