graphprototype.get

תיאור

integer/array graphprototype.get(object parameters)

השיטה מאפשרת לשלוף אבות טיפוס גרפים לפי הנתון פרמטרים.

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

פרמטרים

(object) פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

פרמטר סוג תיאור
discoveryids string/array החזר רק אבות טיפוס של גרפים השייכים לכללי הגילוי הנתונים.
graphids string/array החזר רק אבות טיפוס של גרפים עם המזהים הנתונים.
groupids string/array החזר רק אבות טיפוס של גרפים השייכים למארחים בקבוצות המארחות הנתונות.
hostids string/array החזר רק אבות טיפוס של גרפים השייכים למארחים הנתונים.
herited boolean אם הוגדר כ-'true' החזר רק אבות טיפוס של גרפים שעברו בירושה מתבנית.
itemids string/array החזר רק אבות טיפוס גרפים המכילים את אבות הטיפוס של הפריט הנתון.
templated boolean אם מוגדר כ-'true' החזר רק אבות טיפוס של גרפים השייכים לתבניות.
templateids string/array החזר רק אבות טיפוס של גרפים השייכים לתבניות הנתונות.
selectDiscoveryRule query החזר מאפיין discoveryRule עם כלל LLD שאליו שייך אב הטיפוס של הגרף.
selectGraphItems query החזר מאפיין gitems עם פריטי הגרף המשמשים באב הטיפוס של הגרף.
selectGroups query החזר מאפיין groups עם קבוצות המארחים שאליהן שייך אב הטיפוס של הגרף.
selectHosts query החזר מאפיין hosts עם המארחים שאליהם שייך אב הטיפוס של הגרף.
selectItems query החזר מאפיין items עם items ו-item prototypes בשימוש באב הטיפוס של הגרף .
selectTemplates query החזר מאפיין templates עם התבניות שלהן שייך אב הטיפוס של הגרף.
filter object החזר רק את התוצאות שתואמות בדיוק את המסנן הנתון.

מקבל מערך, כאשר המפתחות הם שמות מאפיינים, והערכים הם ערך בודד או מערך של ערכים שיש להתאים.

תומך במסננים נוספים:
host - שם טכני של המארח שאליו שייך אב הטיפוס של הגרף;
hostid - מזהה המארח שאליו שייך אב הטיפוס של הגרף.
sortfield string/array מיין את התוצאה לפי המאפיינים הנתונים.

ערכים אפשריים הם: graphid, name ו-graphtype.
countOutput boolean הפרמטרים הללו המשותפים לכל שיטות ה-'get' מתוארים בפירוט בפירוש ההתייחסות.
עריכה בוליאנית
excludeSearch בולאני
limit מספר שלם
פלט שאילתה
preservekeys בולאני
חיפוש אובייקט
searchByAny boolean
searchWildcardsEnabled boolean
sortorder מחרוזת/מערך
startSearch boolean

החזר ערכים

(מספר שלם/מערך) מחזיר אחד:

  • מערך של חפצים;
  • ספירת האובייקטים שאוחזרו, אם יש לפרמטר countOutput נעשה שימוש.

דוגמאות

אחזור אבות טיפוס של גרפים מכלל LLD

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

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "graphprototype.get",
            "params": {
                "output": "להרחיב",
                "discoveryids": "27426"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "graphid": "1017",
                    "parent_itemid": "27426",
                    "name": "שימוש בשטח דיסק {#FSNAME}",
                    "width": "600",
                    "height": "340",
                    "yaxismin": "0.0000",
                    "yaxismax": "0.0000",
                    "templateid": "442",
                    "show_work_period": "0",
                    "show_trigers": "0",
                    "graphtype": "2",
                    "show_legend": "1",
                    "show_3d": "1",
                    "percent_left": "0.0000",
                    "percent_right": "0.0000",
                    "ymin_type": "0",
                    "ymax_type": "0",
                    "ymin_itemid": "0",
                    "ymax_itemid": "0",
                    "לגלות": "0"
                }
            ],
            "מזהה": 1
       }

ראה גם

מקור

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