hostprototype.create

תיאור

object hostprototype.create(object/array hostPrototypes)

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

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

פרמטרים

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

בנוסף לאב-טיפוס המארח הסטנדרטי properties](object#host_prototype), השיטה מקבלת את הדברים הבאים פרמטרים.

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

החזר ערכים

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

דוגמאות

יצירת אב טיפוס מארח

צור אב טיפוס מארח "{#VM.NAME}" על כלל LLD "23542" עם קבוצה אב טיפוס "{#HV.NAME}", זוג תגים "Datacenter": "{#DATACENTER.NAME}" וממשק SNMPv2 מותאם אישית 127.0.0.1:161 עם קהילה {$SNMP_COMMUNITY}. קשר אותו לקבוצה המארח "2".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "hostprototype.create",
            "params": {
                "host": "{#VM.NAME}",
                "ruleid": "23542",
                "custom_interfaces": "1",
                "קבוצת קישורים": [
                    {
                        "groupid": "2"
                    }
                ],
                "groupPrototypes": [
                    {
                        "name": "{#HV.NAME}"
                    }
                ],
                "תגים": [
                    {
                        "tag": "מרכז נתונים",
                        "value": "{#DATACENTER.NAME}"
                    }
                ],
                "ממשקים": [
                    {
                        "main": "1",
                        "type": "2",
                        "useip": "1",
                        "ip": "127.0.0.1",
                        "dns": "",
                        "port": "161",
                        "פרטים": {
                            "גרסה 2",
                            "bulk": "1",
                            "קהילה": "{$SNMP_COMMUNITY}"
                        }
                    }
                ]
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

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

ראה גם

מקור

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

Documentation