[comment]: # ({cdc53a5f-cdc53a5f})
# graph.get

[comment]: # ({/cdc53a5f-cdc53a5f})

[comment]: # ({3409d3a1-d2f8406d})
### תיאור

`integer/array graph.get(object parameters)`

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

::: noteclassic
שיטה זו זמינה למשתמשים מכל סוג. הרשאות
כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/3409d3a1-d2f8406d})

[comment]: # ({83006688-5b1c5b22})
### פרמטרים

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|graphids|string/array|החזר רק גרפים עם המזהים הנתונים.|
|groupids|string/array|החזר רק גרפים השייכים למארחים בקבוצות המארחות הנתונות.|
|templateids|string/array|החזר רק גרף השייך לתבניות הנתונות.|
|hostids|string/array|החזר רק גרפים השייכים למארחים הנתונים.|
|itemids|string/array|החזר רק גרפים המכילים את הפריטים הנתונים.|
|templated|boolean|אם מוגדר כ-'true' החזר רק גרפים השייכים לתבניות.|
|herited|boolean|אם מוגדר כ-'true' החזר רק גרפים שעברו בירושה מתבנית.|
|expandName|flag|הרחבת פקודות מאקרו בשם הגרף.|
|selectGroups|query|החזר מאפיין [groups](/manual/api/reference/hostgroup/object) עם קבוצות המארחים שאליהן שייך הגרף.|
|selectTemplates|query|החזר מאפיין [templates](/manual/api/reference/template/object) עם התבניות שהגרף שייך להן.|
|selectHosts|query|החזר מאפיין [hosts](/manual/api/reference/host/object) עם המארחים שאליהם שייך הגרף.|
|selectItems|query|החזר מאפיין [items](/manual/api/reference/item/object) עם הפריטים המשמשים בגרף.|
|selectGraphDiscovery|query|החזר מאפיין `graphDiscovery` עם אובייקט גילוי הגרף. אובייקטי גילוי הגרף מקשרים את הגרף לאב טיפוס של גרף ממנו הוא נוצר.<br><br>יש לו את המאפיינים הבאים:<br>`graphid` - `(string)` ID של הגרף;<br>` parent_graphid` - מזהה `(string)` של אב הטיפוס של הגרף שממנו נוצר הגרף.|
|selectGraphItems|query|החזר מאפיין [gitems](/manual/api/reference/graphitem/object) עם הפריטים המשמשים בגרף.|
|selectDiscoveryRule|query|החזר מאפיין [discoveryRule](/manual/api/reference/drule/object) עם כלל הגילוי ברמה נמוכה שיצר את הגרף.|
|filter|object|החזר רק את התוצאות שתואמות בדיוק את המסנן הנתון.<br><br>מקבל מערך, כאשר המפתחות הם שמות מאפיינים, והערכים הם ערך בודד או מערך של ערכים שיש להתאים. <br><br>תומך במסננים נוספים:<br>`מארח` - שם טכני של המארח שאליו שייך הגרף;<br>`hostid` - מזהה המארח שאליו שייך הגרף.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `graphid`, `name` ו-`graphtype`.|
|countOutput|boolean|הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף [פרשנות הפניה](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/83006688-5b1c5b22})

[comment]: # ({7223bab1-7223bab1})
### החזר ערכים

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

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

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({fe1484d2-e7fae381})
#### אחזור גרפים ממארחים

אחזר את כל הגרפים מהמארח "10107" ומיון אותם לפי שם.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "graph.get",
     "params": {
         "output": "להרחיב",
         "hostids": 10107,
         "sortfield": "שם"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "graphid": "612",
             "name": "קפיצות מעבד",
             "רוחב": "900",
             "height": "200",
             "yaxismin": "0",
             "yaxismax": "100",
             "templateid": "439",
             "show_work_period": "1",
             "show_trigers": "1",
             "graphtype": "0",
             "show_legend": "1",
             "show_3d": "0",
             "percent_left": "0",
             "percent_right": "0",
             "ymin_type": "0",
             "ymax_type": "0",
             "ymin_itemid": "0",
             "ymax_itemid": "0",
             "flags": "0"
         },
         {
             "graphid": "613",
             "name": "עומס מעבד",
             "רוחב": "900",
             "height": "200",
             "yaxismin": "0",
             "yaxismax": "100",
             "templateid": "433",
             "show_work_period": "1",
             "show_trigers": "1",
             "graphtype": "0",
             "show_legend": "1",
             "show_3d": "0",
             "percent_left": "0",
             "percent_right": "0",
             "ymin_type": "1",
             "ymax_type": "0",
             "ymin_itemid": "0",
             "ymax_itemid": "0",
             "flags": "0"
         },
         {
             "graphid": "614",
             "name": "ניצול מעבד",
             "רוחב": "900",
             "height": "200",
             "yaxismin": "0",
             "yaxismax": "100",
             "templateid": "387",
             "show_work_period": "1",
             "show_trigers": "0",
             "graphtype": "1",
             "show_legend": "1",
             "show_3d": "0",
             "percent_left": "0",
             "percent_right": "0",
             "ymin_type": "1",
             "ymax_type": "1",
             "ymin_itemid": "0",
             "ymax_itemid": "0",
             "flags": "0"
         },
         {
             "graphid": "645",
             "name": "שימוש בשטח דיסק /",
             "width": "600",
             "height": "340",
             "yaxismin": "0",
             "yaxismax": "0",
             "templateid": "0",
             "show_work_period": "0",
             "show_trigers": "0",
             "graphtype": "2",
             "show_legend": "1",
             "show_3d": "1",
             "percent_left": "0",
             "percent_right": "0",
             "ymin_type": "0",
             "ymax_type": "0",
             "ymin_itemid": "0",
             "ymax_itemid": "0",
             "דגלים": "4"
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/fe1484d2-e7fae381})

[comment]: # ({ff830d25-e4f96e80})
### ראה גם

- [גילוי
     כלל](/manual/api/reference/discoveryrule/object#discovery_rule)
- [פריט גרף](/manual/api/reference/graphitem/object#graph_item)
- [פריט](/manual/api/reference/item/object#item)
- [מארח](/manual/api/reference/host/object#host)
- [קבוצת מארח](/manual/api/reference/hostgroup/object#host_group)
- [תבנית](/manual/api/reference/template/object#template)

[comment]: # ({/ff830d25-e4f96e80})

[comment]: # ({6f7b2d0a-6f7b2d0a})
### מקור

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

[comment]: # ({/6f7b2d0a-6f7b2d0a})