העצמים הבאים קשורים ישירות ל־API hostinterface
.
לאובייקט ממשק המארח יש את המאפיינים הבאים.
::: הערה חשוב שים לב שנדרשים גם IP וגם DNS. אם אתה כן לא רוצה להשתמש ב-DNS, הגדר אותו למחרוזת ריקה. :::
Property | Type | תיאור |
---|---|---|
זמין | מספר שלם | (קריאה בלבד) זמינות ממשק המארח. ערכים אפשריים הם: 0 - (ברירת מחדל) לא ידוע; 1 - זמין; 2 - לא זמין . |
פרטים | מערך | אובייקט נוסף לממשק. חובה אם 'סוג' הממשק הוא SNMP. |
disable_until | timestamp | (לקריאה בלבד) זמן הסקר הבא של ממשק מארח לא זמין. |
dns (נדרש) |
מחרוזת | שם ה-DNS המשמש את הממשק. יכול להיות ריק אם החיבור מתבצע באמצעות IP. |
error | string | (קריאה בלבד) טקסט שגיאה אם ממשק המארח אינו זמין. |
errors_from | timestamp | (קריאה בלבד) זמן שבו ממשק המארח לא זמין. |
hostid (נדרש) |
string | מזהה המארח שאליו שייך הממשק. |
interfaceid | string | (לקריאה בלבד) מזהה הממשק. |
ip (נדרש) |
string | כתובת IP המשמשת את הממשק. יכול להיות ריק אם החיבור מתבצע באמצעות DNS. |
ראשי (נדרש) |
מספר שלם | האם הממשק משמש כברירת מחדל במארח. ניתן להגדיר רק ממשק אחד מסוג כלשהו כברירת מחדל במארח. ערכים אפשריים הם: 0 - לא ברירת מחדל; 1 - ברירת מחדל. |
יציאה (נדרש) |
string | מספר יציאה המשמש את הממשק. יכול להכיל פקודות מאקרו של משתמש. |
סוג (נדרש) |
מספר שלם | סוג ממשק. ערכים אפשריים הם: 1 - סוכן; 2 - SNMP; 3 - IPMI;< br>4 - JMX. |
useip (נדרש) |
מספר שלם | האם יש לבצע את החיבור באמצעות IP. ערכים אפשריים הם: 0 - התחבר באמצעות שם DNS מארח; 1 - התחבר באמצעות כתובת IP מארח עבור ממשק מארח זה. |
שימו לב שעבור שיטות מסוימות (עדכון, מחק) שילוב הפרמטרים הנדרש/אופציונלי שונה.
לאובייקט הפרטים יש את המאפיינים הבאים.
Property | Type | תיאור |
---|---|---|
גרסה (נדרש) |
מספר שלם | גרסת ממשק SNMP. ערכים אפשריים הם: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3 |
bulk | integer | האם להשתמש בבקשות SNMP בכמות גדולה. ערכים אפשריים הם: 0 - אל תשתמש בבקשות בכמות גדולה; 1 - (ברירת מחדל) - השתמש בבקשות בכמות גדולה. |
community | string | קהילת SNMP (חובה). בשימוש רק על ידי ממשקי SNMPv1 ו-SNMPv2. |
securityname | string | שם אבטחה SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. |
רמת אבטחה | מספר שלם | רמת אבטחה SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. ערכים אפשריים הם: 0 - (ברירת מחדל) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
authpassphrase | string | משפט סיסמה לאימות SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. |
privpassphrase | string | משפט סיסמה פרטיות של SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. |
authprotocol | שלם | פרוטוקול אימות SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. ערכים אפשריים הם: 0 - (ברירת מחדל) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256;<br >4 - SHA384; 5 - SHA512. |
privprotocol | שלם | פרוטוקול פרטיות SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. ערכים אפשריים הם: 0 - (ברירת מחדל) - DES; 1 - AES128; 2 - AES192; 3 - AES256;<br >4 - AES192C; 5 - AES256C. |
contextname | string | שם הקשר SNMPv3. בשימוש רק על ידי ממשקי SNMPv3. |