[comment]: # translation:outdated

[comment]: # ({25793162-25793162})
# hostinterface.get

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

[comment]: # ({dec9cf90-29074792})
### תיאור

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

השיטה מאפשרת לאחזר ממשקי מארח בהתאם לנתון
פרמטרים.

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

[comment]: # ({/dec9cf90-29074792})

[comment]: # ({a1435b79-a40e6018})
### פרמטרים

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|hostids|string/array|החזר רק ממשקי מארח המשמשים את המארחים הנתונים.|
|interfaceids|string/array|החזר רק ממשקי מארח עם המזהים הנתונים.|
|itemids|string/array|החזר רק ממשקי מארח המשמשים את הפריטים הנתונים.|
|triggerids|string/array|החזר רק ממשקי מארח המשמשים פריטים בטריגרים הנתונים.|
|selectItems|query|החזר מאפיין [items](/manual/api/reference/host/object) עם הפריטים המשתמשים בממשק.<br><br>תומך ב'count'.|
|selectHosts|query|החזר מאפיין [hosts](/manual/api/reference/host/object) עם מערך של מארחים המשתמשים בממשק.|
|limitSelects|integer|מגביל את מספר הרשומות המוחזרות על ידי subselects.<br><br>חל על subselects הבאות:<br>`selectItems`.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `interfaceid`, `dns`, `ip`.|
|countOutput|boolean|הפרמטרים הללו הנפוצים לכל שיטות ה-'get' מתוארים בפירוט בדף [פרשנות הפניה](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|filter|object|^|
|limit|מספר שלם|^|
|nodeids|מחרוזת/מערך|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/a1435b79-a40e6018})

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

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

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

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

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

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

[comment]: # ({20674227-cbd2e952})
#### אחזר ממשקי מארח

אחזר את כל הנתונים על הממשקים המשמשים את המארח "30057".

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "hostinterface.get",
     "params": {
         "output": "להרחיב",
         "hostids": "30057"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": [
         {
             "interfaceid": "50039",
             "hostid": "30057",
             "main": "1",
             "סוג 1",
             "useip": "1",
             "ip": "::1",
             "dns": "",
             "port": "10050",
             "available": "0",
             "error": "",
             "errors_from": "0",
             "disable_until": "0",
             "פרטים": []
         },
         {
             "interfaceid": "55082",
             "hostid": "30057",
             "main": "0",
             "סוג 1",
             "useip": "1",
             "ip": "127.0.0.1",
             "dns": "",
             "port": "10051",
             "available": "0",
             "error": "",
             "errors_from": "0",
             "disable_until": "0",
             "פרטים": {
                 "גרסה 2",
                 "bulk": "0",
                 "קהילה": "{$SNMP_COMMUNITY}"
             }
         }
     ],
     "מזהה": 1
}
```

[comment]: # ({/20674227-cbd2e952})

[comment]: # ({1c57700e-1c57700e})
### מידע נוסף

-   [מארח](/manual/api/reference/host/object#host)
-   [פריט](/manual/api/reference/item/object#item)

[comment]: # ({/1c57700e-1c57700e})

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

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

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