[comment]: # ({7f8cd3a3-7f8cd3a3})
# httptest.get

[comment]: # ({/7f8cd3a3-7f8cd3a3})

[comment]: # ({33db6921-96cbc36d})
### תיאור

`integer/array httptest.get(object parameters)`

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

::: noteclassic
שיטה זו זמינה למשתמשים מכל סוג. הרשאות
כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/33db6921-96cbc36d})

[comment]: # ({7b2f923c-7be2c19f})
### פרמטרים

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

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

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|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|כללים לחיפוש תגים.<br><br>ערכים אפשריים:<br>0 - (ברירת מחדל) ו/או;<br>2 - או.|
|תגים|מערך אובייקטים|החזר רק תרחישי אינטרנט עם תגיות נתונות. התאמה מדויקת לפי תג וחיפוש תלוי רישיות או רישיות לפי ערך תג בהתאם לערך האופרטור.<br>פורמט: `[{"tag": "<tag>", "value": "<value>", " operator": "<operator>"}, ...]`.<br>מערך ריק מחזיר את כל תרחישי האינטרנט.<br><br>סוגי אופרטורים אפשריים:<br>0 - (ברירת מחדל) Like;<br> 1 - שווה;<br>2 - לא כמו;<br>3 - לא שווה<br>4 - קיים;<br>5 - לא קיים.|
|selectHosts|query|החזר את המארחים שתרחיש האינטרנט שייך אליהם כמערך במאפיין [hosts](/manual/api/reference/host/object).|
|selectSteps|query|החזר את שלבי תרחיש האינטרנט במאפיין [steps](/manual/api/reference/httptest/object#scenario_step).<br><br>תומך ב'count'.|
|selectTags|query|החזר את תגי תרחיש האינטרנט בנכס [tags](/manual/api/reference/httptest/object#web_scenario_tag).|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `httptestid` ו`שם`.|
|countOutput|boolean|הפרמטרים הללו המשותפים לכל שיטות ה-'get' מתוארים בפירוט ב[פירוש ההתייחסות](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|filter|object|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/7b2f923c-7be2c19f})

[comment]: # ({7223bab1-7223bab1})
### החזר ערכים

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

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

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({df95c712-c93618d6})
#### אחזור תרחיש אינטרנט

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

בַּקָשָׁה:

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

תְגוּבָה:

``` json
{
     "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
}
```

[comment]: # ({/df95c712-c93618d6})

[comment]: # ({ce685d69-ce685d69})
### מידע נוסף

-   [מארח](/manual/api/reference/host/object#host)
-   [שלב תרחיש](object#scenario_step)

[comment]: # ({/ce685d69-ce685d69})

[comment]: # ({8ec619ff-8ec619ff})
### מקור

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

[comment]: # ({/8ec619ff-8ec619ff})