httptest.get

תיאור

integer/array httptest.get(object parameters)

השיטה מאפשרת לאחזר תרחישי אינטרנט בהתאם לנתון פרמטרים.

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

פרמטרים

(object) פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

פרמטר סוג תיאור
groupids string/array החזר רק תרחישי אינטרנט השייכים לקבוצות המארחות הנתונות.
hostids string/array החזר רק תרחישי אינטרנט השייכים למארחים הנתונים.
httptestid string/array החזר רק תרחישי אינטרנט עם המזהים הנתונים.
herited boolean אם הוגדר כ-'true' החזר רק תרחישי אינטרנט שעברו בירושה מתבנית.
monitored boolean אם מוגדר כ-'true' החזר רק תרחישי אינטרנט מופעלים השייכים למארחים מנוטרים.
templated boolean אם מוגדר כ-'true' החזר רק תרחישי אינטרנט השייכים לתבניות.
templateids string/array החזר רק תרחישי אינטרנט השייכים לתבניות הנתונות.
expandName flag הרחבת פקודות מאקרו בשם תרחיש האינטרנט.
expandStepName flag הרחבת פקודות מאקרו בשמות של שלבי התרחיש.
evaltype integer כללים לחיפוש תגים.

ערכים אפשריים:
0 - (ברירת מחדל) ו/או;
2 - או.
תגים מערך אובייקטים החזר רק תרחישי אינטרנט עם תגיות נתונות. התאמה מדויקת לפי תג וחיפוש תלוי רישיות או רישיות לפי ערך תג בהתאם לערך האופרטור.
פורמט: [{"tag": "<tag>", "value": "<value>", " operator": "<operator>"}, ...].
מערך ריק מחזיר את כל תרחישי האינטרנט.

סוגי אופרטורים אפשריים:
0 - (ברירת מחדל) Like;
1 - שווה;
2 - לא כמו;
3 - לא שווה
4 - קיים;
5 - לא קיים.
selectHosts query החזר את המארחים שתרחיש האינטרנט שייך אליהם כמערך במאפיין hosts.
selectSteps query החזר את שלבי תרחיש האינטרנט במאפיין steps.

תומך ב'count'.
selectTags query החזר את תגי תרחיש האינטרנט בנכס tags.
sortfield string/array מיין את התוצאה לפי המאפיינים הנתונים.

ערכים אפשריים הם: httptestid ושם.
countOutput boolean הפרמטרים הללו המשותפים לכל שיטות ה-'get' מתוארים בפירוט בפירוש ההתייחסות.
עריכה בוליאנית
excludeSearch בולאני
filter object
limit מספר שלם
פלט שאילתה
preservekeys בולאני
חיפוש אובייקט
searchByAny boolean
searchWildcardsEnabled boolean
sortorder מחרוזת/מערך
startSearch boolean

החזר ערכים

(מספר שלם/מערך) מחזיר אחד:

  • מערך של חפצים;
  • ספירת האובייקטים שאוחזרו, אם יש לפרמטר countOutput נעשה שימוש.

דוגמאות

אחזור תרחיש אינטרנט

אחזר את כל הנתונים על תרחיש אינטרנט "4".

בַּקָשָׁה:

{
            "jsonrpc": "2.0",
            "method": "httptest.get",
            "params": {
                "output": "להרחיב",
                "selectSteps": "להרחיב",
                "httptestid": "9"
            },
            "auth": "038e1d7b1735c6a5436ee9eae095879e",
            "מזהה": 1
       }

תְגוּבָה:

{
            "jsonrpc": "2.0",
            "תוצאה": [
                {
                    "httptestid": "9",
                    "name": "בדיקת דף הבית",
                    "nextcheck": "0",
                    "delay": "1m",
                    "status": "0",
                    "משתנים": [],
                    "agent": "Zabbix",
                    "authentication": "0",
                    "http_user": "",
                    "http_password": "",
                    "hostid": "10084",
                    "templateid": "0",
                    "http_proxy": "",
                    "מחדש": "1",
                    "ssl_cert_file": "",
                    "ssl_key_file": "",
                    "ssl_key_password": "",
                    "verify_peer": "0",
                    "verify_host": "0",
                    "כותרות": [],
                    "צעדים": [
                        {
                            "httpstepid": "36",
                            "httptestid": "9",
                            "name": "דף הבית",
                            "לא": "1",
                            "url": "http://example.com",
                            "פסק זמן": "15 שניות",
                            "פוסטים": "",
                            "נדרש": "",
                            "status_codes": "200",
                            "משתנים": [
                                {
                                    "name":"{var}",
                                    "value": "12"
                                }
                            ],
                            "follow_redirects": "1",
                            "retrieve_mode": "0",
                            "כותרות": [],
                            "query_fields": []
                        },
                        {
                            "httpstepid": "37",
                            "httptestid": "9",
                            "name": "דף הבית / אודות",
                            "לא": "2",
                            "url": "http://example.com/about",
                            "פסק זמן": "15 שניות",
                            "פוסטים": "",
                            "נדרש": "",
                            "status_codes": "200",
                            "משתנים": [],
                            "follow_redirects": "1",
                            "retrieve_mode": "0",
                            "כותרות": [],
                            "query_fields": []
                        }
                    ]
                }
            ],
            "מזהה": 1
       }

מידע נוסף

מקור

CHttpTest::get()‎ בתוך ui/include/classes/api/services/CHttpTest.php.