> עצם מנשק מארח

העצמים הבאים קשורים ישירות ל־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.