This is a translation of the original English documentation page. Help us make it better.

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.