> עצם משימה

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

פעולה

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

Property	Type	תיאור
actionid	string	(לקריאה בלבד) מזהה הפעולה.
esc_period (נדרש)	string	משך שלב הפעולה המוגדר כברירת מחדל. חייב להיות לפחות 60 שניות. מקבל שניות, יחידת זמן עם סיומת ומקרו משתמש. שים לב שהסלמות נתמכות רק עבור פעולות טריגר, פנימיות ושירות, ורק בפעולות רגילות.
מקור אירועים (נדרש)	מספר שלם	(קבוע) סוג האירועים שהפעולה תטפל בהם. עיין במאפיין האירוע "מקור" עבור רשימה של סוגי אירועים נתמכים.
שם (חובה)	מחרוזת	שם הפעולה.
status	integer	האם הפעולה מופעלת או מושבתת. ערכים אפשריים: 0 - (ברירת מחדל) מופעלת; 1 - מושבת.
pause_suppressed	integer	האם להשהות את ההסלמה במהלך תקופות תחזוקה או לא. ערכים אפשריים: 0 - אל תשהה את ההסלמה; 1 - (ברירת מחדל) השהה את ההסלמה. שים לב שהפרמטר הזה תקף לפעולות טריגר בלבד.
notify_if_cancelled	intall	האם להודיע בעת ביטול ההסלמה. ערכים אפשריים: 0 - אל תודיע כאשר ההסלמה מבוטלת; 1 - (ברירת מחדל) הודע כאשר ההסלמה מבוטלת. שים לב שפרמטר זה תקף לפעולות טריגר בלבד.

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

פעולת פעולה

אובייקט פעולת הפעולה מגדיר פעולה שתתבצע כאשר מבוצעת פעולה. יש לו את המאפיינים הבאים.

Property	Type	תיאור
operationid	string	(קריאה בלבד) מזהה פעולת הפעולה.
סוג פעולה (נדרש)	מספר שלם	סוג הפעולה. ערכים אפשריים: 0 - שלח הודעה; 1 - סקריפט גלובלי; 2 - הוסף מארח; 3 - הסר מארח; 4 - הוסף לקבוצת המארח; 5 - הסר מקבוצת המארח; 6 - קישור לתבנית; 7 - בטל קישור מתבנית;<br >8 - הפעל מארח; 9 - השבת מארח; 10 - הגדר מצב מלאי מארח. שים לב שרק הסוגים '0' ו-'1' נתמכים עבור פעולות טריגר ושירות, בלבד '0' נתמך עבור פעולות פנימיות. כל הסוגים נתמכים עבור פעולות גילוי ורישום אוטומטי.
actionid	string	(readonly) מזהה הפעולה שאליה שייכת הפעולה.
esc_period	string	משך שלב הסלמה בשניות. חייב להיות יותר מ-60 שניות. מקבל שניות, יחידת זמן עם סיומת ומקרו משתמש. אם מוגדר ל-0 או 0s, ישמש תקופת ההסלמה של פעולות ברירת המחדל. ברירת מחדל: 0s. שים לב שהסלמות נתמכות רק עבור פעולות טריגר, פנימיות ופעולות שירות, ורק במצב רגיל פעולות.
esc_step_from	integer	שלב לתחילת הסלמה. ברירת מחדל: 1. שים לב שהסלמות נתמכות רק עבור פעולות טריגר, פנימיות ושירות, ורק בפעולות רגילות .
esc_step_to	integer	שלב לסיום הסלמה ב. ברירת מחדל: 1. שים לב שהסלמות נתמכות רק עבור פעולות טריגר, פנימיות ושירות, ורק בפעולות רגילות .
evaltype	integer	שיטת הערכת מצב פעולה. ערכים אפשריים: 0 - (ברירת מחדל) AND / OR; 1 - AND; 2 - OR.
opcommand	object	אובייקט המכיל נתונים על סקריפט גלובלי המופעל על ידי הפעולה. לכל אובייקט יש מאפיין אחד הבא: `scriptid` - (string) מזהה הסקריפט. חובה עבור פעולות סקריפט גלובליות.
opcommand_grp	array	קבוצות מארחות להרצת סקריפטים גלובליים. לכל אובייקט יש את המאפיינים הבאים: `opcommand_grpid` - (מחרוזת, לקריאה בלבד) מזהה האובייקט; `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `groupid` - (מחרוזת) מזהה הקבוצה המארחת. נדרש עבור פעולות סקריפט גלובליות אם `opcommand_hst` הוא לא מוגדר.
opcommand_hst	מערך	מארח להפעלת סקריפטים גלובליים. לכל אובייקט יש את המאפיינים הבאים: `opcommand_hstid` - (מחרוזת, לקריאה בלבד) מזהה האובייקט; `operationid` - (מחרוזת, קריאה בלבד) מזהה הפעולה; `hostid` - (מחרוזת) מזהה המארח; אם מוגדר ל-0 הפקודה תופעל על המארח הנוכחי. נדרשת עבור פעולות סקריפט גלובליות אם `opcommand_grp` לא מוגדר.
opconditions	מערך	תנאי פעולה המשמשים לפעולות טריגר. אובייקט תנאי הפעולה הוא מתואר בפירוט למטה.
opgroup	מערך	קבוצות מארחות להוספת מארחים. לכל אובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `groupid` - (מחרוזת) מזהה הקבוצה המארחת. נדרש עבור פעולות "הוסף לקבוצת מארח" ו"הסר מקבוצת המארחת".
opmessage	object	אובייקט המכיל את הנתונים על ההודעה שנשלחה על ידי הפעולה. אובייקט הודעת הפעולה הוא מתואר בפירוט למטה.< br> נדרש עבור פעולות הודעה.
opmessage_grp	array	קבוצות משתמשים שאליהן יש לשלוח הודעות. לכל אובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, קריאה בלבד) מזהה הפעולה; `usrgrpid` - (string) מזהה קבוצת המשתמשים. נדרש עבור פעולות הודעה אם `opmessage_usr` אינו מוגדר.
opmessage_usr	array	משתמשים אליהם יש לשלוח הודעות. לכל אובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `userid` - (string) מזהה המשתמש. נדרש עבור פעולות הודעה אם `opmessage_grp` אינו מוגדר.
optemplate	מערך	תבניות לקישור המארחים. לכל אובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `templateid` - (מחרוזת) מזהה התבנית. נדרש עבור פעולות "קישור לתבנית" ו"ביטול קישור מתבנית".
opinventory	object	מצב מלאי הגדר את המארח ל. לאובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `inventory_mode` - * (מחרוזת)* מצב מלאי. נדרש עבור פעולות "הגדר מצב מלאי מארח".

הודעת פעולת פעולה

אובייקט הודעת הפעולה מכיל נתונים על ההודעה שתעשה זאת להישלח על ידי המבצע.

Property	Type	תיאור
default_msg	integer	האם להשתמש בטקסט ובנושא ברירת המחדל של הודעת הפעולה. ערכים אפשריים: 0 - השתמש בנתונים מהפעולה; 1 - (ברירת מחדל) השתמש הנתונים מסוג המדיה.
mediatypeid	string	מזהה של סוג המדיה שישמש לשליחת ההודעה.
message	string	טקסט הודעת פעולה.
subject	string	נושא הודעת הפעולה.

מצב פעולת פעולה

האובייקט תנאי פעולת הפעולה מגדיר תנאי שחייב להיות נפגש כדי לבצע את הפעולה הנוכחית. יש לו את המאפיינים הבאים.

Property	Type	תיאור
opconditionid	string	(לקריאה בלבד) מזהה תנאי פעולת הפעולה
סוג מצב (נדרש)	מספר שלם	סוג המצב. ערכים אפשריים: 14 - מאושרת.
ערך (חובה)	מחרוזת	ערך להשוואה.
operationid	string	(לקריאה בלבד) מזהה הפעולה.
operator	integer	אופרטור תנאי. ערכים אפשריים: 0 - (ברירת מחדל) =.

האופרטורים והערכים הבאים נתמכים עבור כל פעולה סוג מצב.

|מצב|שם תנאי|אופרטורים נתמכים|ערך צפוי| |--------|--------------|----------------|---- ----------| |14|האירוע מאושר|=|האם האירוע מאושר.

ערכים אפשריים:
0 - לא מאושר;
1 - מאושרת.|

פעולת שחזור פעולה

אובייקט פעולת שחזור הפעולה מגדיר פעולה שתהיה מבוצע כאשר בעיה נפתרה. פעולות שחזור אפשריות לפעולות טריגר, פנימיות ושירותיות. יש לו את הדברים הבאים נכסים.

Property	Type	תיאור
operationid	string	(קריאה בלבד) מזהה פעולת הפעולה.
סוג פעולה (נדרש)	מספר שלם	סוג הפעולה. ערכים אפשריים לפעולות טריגר ושירות: 0 - שלח הודעה; 1 - סקריפט גלובלי;< br>11 - הודע לכל המעורבים. ערכים אפשריים לפעולות פנימיות: 0 - שלח הודעה; 11 - הודע לכל המעורבים.
actionid	string	(readonly) מזהה הפעולה שאליה שייכת פעולת השחזור.
opcommand	object	אובייקט מכיל נתונים על סקריפט מסוג פעולה גלובלי המופעל על ידי הפעולה. לכל אובייקט יש מאפיין אחד: `scriptid` - (מחרוזת) מזהה של סקריפט מסוג הפעולה. נדרש עבור פעולות סקריפט גלובליות.
opcommand_grp	array	קבוצות מארחות להרצת סקריפטים גלובליים. לכל אובייקט יש את המאפיינים הבאים: `opcommand_grpid` - (מחרוזת, לקריאה בלבד) מזהה האובייקט; `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `groupid` - (מחרוזת) מזהה הקבוצה המארחת. נדרש עבור פעולות סקריפט גלובליות אם `opcommand_hst` הוא לא מוגדר.
opcommand_hst	מערך	מארח להפעלת סקריפטים גלובליים. לכל אובייקט יש את המאפיינים הבאים: `opcommand_hstid` - (מחרוזת, לקריאה בלבד) מזהה האובייקט; `operationid` - (מחרוזת, קריאה בלבד) מזהה הפעולה; `hostid` - (מחרוזת) מזהה המארח; אם מוגדר ל-0 הפקודה תופעל על המארח הנוכחי. נדרשת עבור פעולות סקריפט גלובליות אם `opcommand_grp` לא מוגדר.
opmessage	object	אובייקט המכיל את הנתונים על ההודעה שנשלחה על ידי פעולת השחזור. אובייקט הודעת הפעולה הוא מתואר בפירוט למעלה. נדרש עבור פעולות הודעה.
opmessage_grp	array	קבוצות משתמשים שאליהן יש לשלוח הודעות. לכל אובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, קריאה בלבד) מזהה הפעולה; `usrgrpid` - (string) מזהה קבוצת המשתמשים. נדרש עבור פעולות הודעה אם `opmessage_usr` אינו מוגדר.
opmessage_usr	array	משתמשים אליהם יש לשלוח הודעות. לכל אובייקט יש את המאפיינים הבאים: `operationid` - (מחרוזת, לקריאה בלבד) מזהה הפעולה; `userid` - (string) מזהה המשתמש. נדרש עבור פעולות הודעה אם `opmessage_grp` אינו מוגדר.

פעולת עדכון פעולה

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

Property	Type	תיאור
operationid	string	(קריאה בלבד) מזהה פעולת הפעולה.
סוג פעולה (נדרש)	מספר שלם	סוג הפעולה. ערכים אפשריים לפעולות טריגר ושירות: 0 - שלח הודעה; 1 - סקריפט גלובלי;< br>12 - הודע לכל המעורבים.
opcommand	object	אובייקט המכיל נתונים על סקריפט מסוג פעולה גלובלי המופעל על ידי הפעולה. לכל אובייקט יש מאפיין אחד הבא: `scriptid` - (מחרוזת) מזהה של הסקריפט של סוג הפעולה. נדרש עבור פעולות סקריפט גלובליות.
opcommand_grp	array	קבוצות מארחות להרצת סקריפטים גלובליים. לכל אובייקט יש את המאפיינים הבאים: `groupid` - (string) מזהה הקבוצה המארחת. < br>נדרש עבור פעולות סקריפט גלובליות אם 'opcommand_hst' לא מוגדר.
opcommand_hst	array	מארח להפעלת סקריפטים גלובליים. לכל אובייקט יש את המאפיינים הבאים: `hostid` - (string) מזהה המארח; אם מוגדר ל-0 הפקודה תופעל על המארח הנוכחי. נדרשת עבור פעולות סקריפט גלובליות אם `opcommand_grp` לא מוגדר.
opmessage	object	אובייקט המכיל את הנתונים על ההודעה שנשלחה על ידי פעולת העדכון. אובייקט הודעת הפעולה הוא מתואר בפירוט למעלה.
opmessage_grp	array	קבוצות משתמשים לשלוח אליהן הודעות. לכל אובייקט יש את המאפיינים הבאים: `usrgrpid` - (string) מזהה קבוצת המשתמשים. <br >נדרש רק עבור פעולות `שלח הודעה` אם `opmessage_usr` אינו מוגדר. מתעלמים ממנו עבור פעולות `שלח הודעה עדכון`.
opmessage_usr	array	משתמשים אליהם יש לשלוח הודעות. לכל אובייקט יש את המאפיינים הבאים: `userid` - (string) מזהה המשתמש. חובה רק עבור פעולות `שלח הודעה` אם `opmessage_grp` אינו מוגדר. מתעלמים ממנו עבור פעולות `שלח עדכון הודעה`.

מסנן פעולה

אובייקט מסנן הפעולה מגדיר קבוצה של תנאים שיש לעמוד בהם לבצע את פעולות הפעולה המוגדרות. יש לו את הדברים הבאים נכסים.

Property	Type	תיאור
תנאים (חובה)	מערך	סט של תנאי סינון לשימוש לסינון תוצאות.
evaltype (חובה)	מספר שלם	שיטת הערכת מצב מסנן. ערכים אפשריים: 0 - ו/או; 1 - ו; 2 - או; 3 - ביטוי מותאם אישית.
eval_formula	string	(לקריאה בלבד) ביטוי שנוצר שישמש להערכת תנאי סינון. הביטוי מכיל מזהים שמתייחסים לתנאי סינון ספציפיים לפי ה'נוסחה' שלו. הערך של `eval_formula` שווה לערך של `נוסחה` עבור מסננים עם ביטוי מותאם אישית.
formula	string	ביטוי מוגדר על ידי משתמש לשימוש להערכת תנאים של מסננים עם ביטוי מותאם אישית. הביטוי חייב להכיל מזהים שמתייחסים לתנאי סינון ספציפיים לפי ה'נוסחה' שלו. המזהים המשמשים בביטוי חייבים להתאים בדיוק לאלו שהוגדרו בתנאי הסינון: אין אפשרות להישאר ללא שימוש או להשמיט שום תנאי. נדרש עבור מסנני ביטויים מותאמים אישית.

מצב מסנן פעולה

אובייקט תנאי מסנן הפעולה מגדיר תנאי ספציפי ש יש לבדוק לפני הפעלת פעולות הפעולה.

Property	Type	תיאור
conditionid	string	(לקריאה בלבד) מזהה תנאי הפעולה.
סוג מצב (נדרש)	מספר שלם	סוג התנאי. ערכים אפשריים עבור פעולות טריגר: 0 - קבוצת מארח; 1 - מארח; 2 - trigger; 3 - טריgger name; 4 - trigger severity; 6 - פרק זמן; 13 - תבנית מארח; 16 - הבעיה מדוכאת; 25 - אירוע תג; 26 - ערך תג אירוע. ערכים אפשריים עבור פעולות גילוי: 7 - מארח IP; 8 - סוג שירות שהתגלה; 9 - יציאת שירות התגלתה;< br>10 - סטטוס גילוי; 11 - זמן פעילות או השבתה; 12 - ערך קיבל; 18 - כלל גילוי; 19 - בדיקת גילוי; 20 - proxy;<br >21 - אובייקט גילוי. ערכים אפשריים עבור פעולות רישום אוטומטי: 20 - proxy; 22 - שם מארח; 24 - מטא נתונים של מארח. ערכים אפשריים עבור פעולות פנימיות: 0 - קבוצת מארח; 1 - מארח; 13 - תבנית מארח; 23 - סוג אירוע; 25 - תג אירוע; 26 - ערך תג אירוע . ערכים אפשריים עבור פעולות שירות: 25 - תג אירוע; 26 - ערך תג אירוע; 27 - שירות; 28 - שם שירות.
ערך (חובה)	מחרוזת	ערך להשוואה.
value2	string	ערך משני להשוואה. נדרש עבור פעולות טריגר, פנימיות ושירות כאשר סוג התנאי הוא 26.
actionid	string	(readonly) מזהה הפעולה שאליה שייך התנאי.
formulaid	string	מזהה ייחודי שרירותי המשמש להפניה לתנאי מביטוי מותאם אישית. יכול להכיל רק אותיות רישיות. המזהה חייב להיות מוגדר על ידי המשתמש בעת שינוי תנאי הסינון, אך יופק מחדש בעת בקשתם לאחר מכן.
operator	מספר שלם	אופרטור תנאי. ערכים אפשריים: 0 - (ברירת מחדל) שווה; 1 - אינו שווה; 2 - מכיל; 3 - אינו מכיל; 4 - ב; 5 - גדול או שווה; 6 - קטן או שווה; 7 - לא ב; 8 - מתאים;<br >9 - לא תואם; 10 - כן; 11 - לא.

כדי להבין טוב יותר כיצד להשתמש במסננים עם שונים סוגי ביטויים, ראה דוגמאות על action.get ו שיטת action.create. דפים.

האופרטורים והערכים הבאים נתמכים עבור כל תנאי סוּג.

מצב	שם תנאי	אופרטורים נתמכים	ערך צפוי
0	קבוצת מארח	שווה, אינו שווה	מזהה קבוצת מארח.
1	מארח	שווה, אינו שווה	מזהה מארח.
2	טריגר	שווה, אינו שווה	מזהה טריגר.
3	שם טריגר	מכיל, אינו מכיל	שם טריגר.
4	חומרת הטריגר	שווה, אינה שווה, גדולה או שווה, קטנה או שווה	חומרת הטריגר. עיין במאפיין trigger "severity" לקבלת רשימה של חומרות טריגרים נתמכות.
5	ערך טריגר	שווה	ערך טריגר. עיין במאפיין trigger "value" לקבלת רשימה של ערכי טריגר נתמכים.
6	תקופת זמן	in, לא in	זמן שבו האירוע הופעל כ-תקופת זמן.
7	מארח IP	שווה, אינו שווה	טווח IP אחד או כמה לבדיקה מופרדים בפסיקים. עיין בסעיף תצורת גילוי רשת למידע נוסף על פורמטים נתמכים של טווחי IP.
8	סוג השירות שהתגלה	שווה, אינו שווה	סוג השירות שהתגלה. סוג השירות תואם לסוג בדיקת הגילוי המשמשת לאיתור השירות. עיין במאפיין המאפיין "סוג" של בדיקת גילוי לקבלת רשימה של סוגים נתמכים.
9	יציאת שירות שהתגלתה	שווה, אינה שווה	טווח יציאה אחד או כמה מופרדים בפסיקים.
10	סטטוס גילוי	שווה	סטטוס של אובייקט שהתגלה. ערכים אפשריים: 0 - מארח או שירות למעלה; 1 - מארח או שירות למטה; 2 - מארח או שירות התגלה; 3 - מארח או שירות אבדו.
11	זמן פעילות או זמן השבתה	גדול או שווה, קטן או שווה	זמן המציין כמה זמן האובייקט שהתגלה נמצא במצב הנוכחי בשניות.
12	ערכים שהתקבלו	שווה, אינו שווה, גדול או שווה, קטן או שווה, מכיל, אינו מכיל	ערך שהוחזר בעת ביצוע סוכן Zabbix, בדיקת גילוי SNMPv1, SNMPv2 או SNMPv3.
13	תבנית מארח	שווה, אינה שווה	מזהה תבנית מקושרת.
16	הבעיה מדוכאת	כן, לא	לא נדרש ערך: שימוש באופרטור "כן" פירושו שיש לדכא את הבעיה, "לא" - לא לדכא.
18	כלל גילוי	שווה, אינו שווה	מזהה של כלל הגילוי.
19	בדיקת גילוי	שווה, אינה שווה	מזהה של בדיקת הגילוי.
20	פרוקסי	שווה, אינו שווה	מזהה של ה-proxy.
21	אובייקט גילוי	שווה	Typ

Documentation