Documentation
Table of Contents
action.get
תיאור
integer/array action.get(object parameters)
השיטה מאפשרת לאחזר פעולות לפי הפרמטרים הנתונים.
שיטה זו זמינה למשתמשים מכל סוג. הרשאות כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה משתמש תפקידים למידע נוסף.
פרמטרים
(object) פרמטרים המגדירים את הפלט הרצוי.
השיטה תומכת בפרמטרים הבאים.
| פרמטר | סוג | תיאור |
|---|---|---|
| actionids | string/array | החזר רק פעולות עם המזהים הנתונים. |
| groupids | string/array | החזר רק פעולות המשתמשות בקבוצות המארחות הנתונות בתנאי פעולה. |
| hostids | string/array | החזר רק פעולות המשתמשות במארחים הנתונים בתנאי פעולה. |
| triggerids | string/array | החזר רק פעולות המשתמשות בטריגרים הנתונים בתנאי פעולה. |
| mediatypeids | string/array | החזר רק פעולות המשתמשות בסוגי המדיה הנתונים לשליחת הודעות. |
| usrgrpids | string/array | החזר רק פעולות המוגדרות לשלוח הודעות לקבוצות המשתמשים הנתונות. |
| userids | string/array | החזר רק פעולות המוגדרות לשלוח הודעות למשתמשים הנתונים. |
| scriptids | string/array | החזר רק פעולות המוגדרות להריץ את הסקריפטים הנתונים. |
| selectFilter | query | החזר מאפיין filter עם מסנן תנאי הפעולה. |
| selectOperations | query | החזר מאפיין operations עם פעולות פעולה. |
| selectRecoveryOperations | query | החזר מאפיין recovery_operations עם פעולות שחזור פעולה. |
| selectUpdateOperations | query | החזר מאפיין update_operations עם פעולות עדכון פעולה. |
| sortfield | string/array | מיין את התוצאה לפי המאפיינים הנתונים. ערכים אפשריים הם: actionid, name וstatus. |
| countOutput | boolean | הפרמטרים האלה משותפים לכל שיטות ה-'get' מתוארים בפירוש ההתייחסות. |
| עריכה | בוליאנית | |
| excludeSearch | בולאני | |
| filter | object | |
| limit | מספר שלם | |
| פלט | שאילתה | |
| preservekeys | בולאני | |
| חיפוש | אובייקט | |
| searchByAny | boolean | |
| searchWildcardsEnabled | boolean | |
| sortorder | מחרוזת/מערך | |
| startSearch | boolean |
ערכים מוחזרים
(integer/array) מחזירה כל אחד מאלה:
- מערך של עצמים;
- כמות העצמים שנמשכו, אם נעשה שימוש במשתנה
countOutput.
דוגמאות
אחזר פעולות טריגר
אחזר את כל פעולות ההדק המוגדרות יחד עם תנאי הפעולה ופעולות.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "action.get",
"params": {
"output": "להרחיב",
"selectOperations": "להרחיב",
"selectRecoveryOperations": "להרחיב",
"selectUpdateOperations": "להרחיב",
"selectFilter": "להרחיב",
"מסנן": {
"מקור אירועים": 0
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": [
{
"actionid": "3",
"name": "דווח על בעיות למנהלי Zabbix",
"eventsource": "0",
"status": "1",
"esc_period": "שעה אחת",
"pause_suppressed": "1",
"מסנן": {
"evaltype": "0",
"נוסחה": "",
"תנאים": [],
"eval_formula": ""
},
"פעולות": [
{
"operationid": "3",
"actionid": "3",
"operationtype": "0",
"esc_period": "0",
"esc_step_from": "1",
"esc_step_to": "1",
"evaltype": "0",
"opconditions": [],
"opmessage": [
{
"default_msg": "1",
"נושא": "",
"הודעה": "",
"mediatypeid" => "0"
}
],
"opmessage_grp": [
{
"usrgrpid": "7"
}
]
}
],
"פעולות_שחזור": [
{
"operationid": "7",
"actionid": "3",
"operationtype": "11",
"evaltype": "0",
"opconditions": [],
"opmessage": {
"default_msg": "0",
"subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}",
"message": "טריגר: {TRIGGER.NAME}\r\nסטטוס טריגר: {TRIGGER.STATUS}\r\nחומרת ההפעלה: {TRIGGER.SEVERITY}\r\nכתובת האתר של טריגר: {TRIGGER.URL}\r\n\ r\nערכי פריט:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({ HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3. {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n \r\nמזהה אירוע מקורי: {EVENT.ID}",
"mediatypeid": "0"
}
}
],
"עדכון_פעולות": [
{
"operationid": "31",
"operationtype": "12",
"evaltype": "0",
"opmessage": {
"default_msg": "1",
"נושא": "",
"הודעה": "",
"mediatypeid": "0"
}
},
{
"operationid": "32",
"operationtype": "0",
"evaltype": "0",
"opmessage": {
"default_msg": "0",
"subject": "עודכן: {TRIGGER.NAME}",
"message": "{USER.FULLNAME} עודכן בעיה ב-{EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} עם ההודעה הבאה:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\ nסטטוס הבעיה הנוכחית הוא {EVENT.STATUS}",
"mediatypeid": "1"
},
"opmessage_grp": [
{
"usrgrpid": "7"
}
],
"opmessage_usr": []
},
{
"operationid": "33",
"operationtype": "1",
"evaltype": "0",
"opcommand": {
"scriptid": "3"
},
"opcommand_hst": [
{
"hostid": "10084"
}
],
"opcommand_grp": []
}
]
}
],
"מזהה": 1
}אחזר פעולות גילוי
אחזר את כל פעולות הגילוי המוגדרות יחד עם הפעולה תנאים ופעולות. המסנן משתמש בסוג ההערכה "ו", אז המאפיין 'נוסחה' ריק ו-'eval_formula' נוצר באופן אוטומטי.
בַּקָשָׁה:
{
"jsonrpc": "2.0",
"method": "action.get",
"params": {
"output": "להרחיב",
"selectOperations": "להרחיב",
"selectFilter": "להרחיב",
"מסנן": {
"מקור אירועים": 1
}
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"מזהה": 1
}תְגוּבָה:
{
"jsonrpc": "2.0",
"תוצאה": [
{
"actionid": "2",
"name": "גילוי אוטומטי. שרתי לינוקס.",
"eventsource": "1",
"status": "1",
"esc_period": "0s",
"pause_suppressed": "1",
"מסנן": {
"evaltype": "0",
"נוסחה": "",
"תנאים": [
{
"conditiontype": "10",
"מפעיל": "0",
"value": "0",
"value2": "",
"formulaid": "B"
},
{
"conditiontype": "8",
"מפעיל": "0",
"value": "9",
"value2": "",
"formulaid": "C"
},
{
"conditiontype": "12",
"מפעיל": "2",
"value": "לינוקס",
"value2": "",
"formulaid": "א"
}
],
"eval_formula": "A ו-B ו-C"
},
"פעולות": [
{
"operationid": "1",
"actionid": "2",
"operationtype": "6",
"esc_period": "0s",
"esc_step_from": "1",
"esc_step_to": "1",
"evaltype": "0",
"opconditions": [],
"optemplate": [
{
"templateid": "10001"
}
]
},
{
"operationid": "2",
"actionid": "2",
"operationtype": "4",
"esc_period": "0s",
"esc_step_from": "1",
"esc_step_to": "1",
"evaltype": "0",
"opconditions": [],
"opgroup": [
{
"groupid": "2"
}
]
}
]
}
],
"מזהה": 1
}מידע נוסף
מקור
CAction::get() בתוך ui/include/classes/api/services/CAction.php.