[comment]: # translation:outdated

[comment]: # ({7ed888d2-7ed888d2})
# > עצם מנשק מארח

העצמים הבאים קשורים ישירות ל־API‏ `hostinterface`.

[comment]: # ({/7ed888d2-7ed888d2})

[comment]: # ({502ab725-ce77a3b0})
### ממשק מארח

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

::: הערה חשוב
שים לב שנדרשים גם IP וגם DNS. אם אתה כן
לא רוצה להשתמש ב-DNS, הגדר אותו למחרוזת ריקה.
:::

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|זמין|מספר שלם|*(קריאה בלבד)* זמינות ממשק המארח.<br><br>ערכים אפשריים הם:<br>0 - *(ברירת מחדל)* לא ידוע;<br>1 - זמין;<br>2 - לא זמין .|
|פרטים|מערך|אובייקט נוסף לממשק. **חובה** אם 'סוג' הממשק הוא SNMP.|
|disable\_until|timestamp|*(לקריאה בלבד)* זמן הסקר הבא של ממשק מארח לא זמין.|
|**dns**<br>(נדרש)|מחרוזת|שם ה-DNS המשמש את הממשק.<br><br>יכול להיות ריק אם החיבור מתבצע באמצעות IP.|
|error|string|*(קריאה בלבד)* טקסט שגיאה אם ממשק המארח אינו זמין.|
|errors\_from|timestamp|*(קריאה בלבד)* זמן שבו ממשק המארח לא זמין.|
|**hostid**<br>(נדרש)|string|מזהה המארח שאליו שייך הממשק.|
|interfaceid|string|*(לקריאה בלבד)* מזהה הממשק.|
|**ip**<br>(נדרש)|string|כתובת IP המשמשת את הממשק.<br><br>יכול להיות ריק אם החיבור מתבצע באמצעות DNS.|
|**ראשי**<br>(נדרש)|מספר שלם|האם הממשק משמש כברירת מחדל במארח. ניתן להגדיר רק ממשק אחד מסוג כלשהו כברירת מחדל במארח.<br><br>ערכים אפשריים הם:<br>0 - לא ברירת מחדל;<br>1 - ברירת מחדל.|
|**יציאה**<br>(נדרש)|string|מספר יציאה המשמש את הממשק. יכול להכיל פקודות מאקרו של משתמש.|
|**סוג**<br>(נדרש)|מספר שלם|סוג ממשק.<br><br>ערכים אפשריים הם:<br>1 - סוכן;<br>2 - SNMP;<br>3 - IPMI;< br>4 - JMX.<br>|
|**useip**<br>(נדרש)|מספר שלם|האם יש לבצע את החיבור באמצעות IP.<br><br>ערכים אפשריים הם:<br>0 - התחבר באמצעות שם DNS מארח;<br>1 - התחבר באמצעות כתובת IP מארח עבור ממשק מארח זה.|

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

[comment]: # ({/502ab725-ce77a3b0})

[comment]: # ({0e373972-3bb71fcc})
### תג פרטים

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

|Property|[Type](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|**גרסה**<br>(נדרש)|מספר שלם|גרסת ממשק SNMP.<br><br>ערכים אפשריים הם:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3|
|bulk|integer|האם להשתמש בבקשות SNMP בכמות גדולה.<br><br>ערכים אפשריים הם:<br>0 - אל תשתמש בבקשות בכמות גדולה;<br>1 - (ברירת מחדל) - השתמש בבקשות בכמות גדולה.|
|community|string|קהילת SNMP (חובה). בשימוש רק על ידי ממשקי SNMPv1 ו-SNMPv2.|
|securityname|string|שם אבטחה SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.|
|רמת אבטחה|מספר שלם|רמת אבטחה SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.<br><br>ערכים אפשריים הם:<br>0 - (ברירת מחדל) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|authpassphrase|string|משפט סיסמה לאימות SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.|
|privpassphrase|string|משפט סיסמה פרטיות של SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.|
|authprotocol|שלם|פרוטוקול אימות SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.<br><br>ערכים אפשריים הם:<br>0 - (ברירת מחדל) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br >4 - SHA384;<br>5 - SHA512.|
|privprotocol|שלם|פרוטוקול פרטיות SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.<br><br>ערכים אפשריים הם:<br>0 - (ברירת מחדל) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br >4 - AES192C;<br>5 - AES256C.|
|contextname|string|שם הקשר SNMPv3. בשימוש רק על ידי ממשקי SNMPv3.|

[comment]: # ({/0e373972-3bb71fcc})