httptest.get

Apraksts

integer/array httptest.get(object parameters)

Metode ļauj izgūt tīmekļa scenārijus atbilstoši norādītajiem parametriem.

Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object) Parametri, kas definē vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parameter Type Description
groupids ID/array Atgriezt tikai tīmekļa scenārijus, kas pieder norādītajām hostu grupām.
hostids ID/array Atgriezt tikai tīmekļa scenārijus, kas pieder norādītajiem hosts.
httptestids ID/array Atgriezt tikai tīmekļa scenārijus ar norādītajiem ID.
inherited boolean Ja iestatīts uz true, atgriezt tikai no veidnes mantotos tīmekļa scenārijus.
monitored boolean Ja iestatīts uz true, atgriezt tikai iespējotos tīmekļa scenārijus, kas pieder uzraudzītiem hosts.
templated boolean Ja iestatīts uz true, atgriezt tikai tīmekļa scenārijus, kas pieder veidnēm.
templateids ID/array Atgriezt tikai tīmekļa scenārijus, kas pieder norādītajām veidnēm.
expandName flag Izvērst makro tīmekļa scenārija nosaukumā.
expandStepName flag Izvērst makro scenārija soļu nosaukumos.
evaltype integer Tagu novērtēšanas metode.

Iespējamās vērtības:
0 - (noklusējums) And/Or;
2 - Or.
tags array Atgriezt tikai tīmekļa scenārijus ar norādītajiem tagiem.
Formāts: [{"tag": "<tag>", "value": "<value>", "operator": "<operator>"}, ...].
Tukšs masīvs atgriež visus tīmekļa scenārijus.

Iespējamās operatora vērtības:
0 - (noklusējums) Contains;
1 - Equals;
2 - Does not contain;
3 - Does not equal;
4 - Exists;
5 - Does not exist.
selectHosts query Atgriezt hosts, kuriem pieder tīmekļa scenārijs, kā masīvu īpašībā hosts.
selectSteps query Atgriezt tīmekļa scenārija soļus īpašībā steps.

Atbalsta count.
selectTags query Atgriezt tīmekļa scenārija tagus īpašībā tags.
sortfield string/array Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: httptestid, name.
countOutput boolean Šie parametri ir aprakstīti atsauces komentārā.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Atgrieztās vērtības

(integer/array) Atgriež vienu no šīm vērtībām:

  • objektu masīvu;
  • iegūto objektu skaitu, ja ir izmantots parametrs countOutput.

Piemēri

Tīmekļa scenārija izgūšana

Iegūt visus datus par tīmekļa scenāriju "9".

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "httptest.get",
    "params": {
        "output": "extend",
        "selectSteps": "extend",
        "httptestids": "9"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "httptestid": "9",
            "name": "Homepage check",
            "delay": "1m",
            "status": "0",
            "variables": [],
            "agent": "Zabbix",
            "authentication": "0",
            "http_user": "",
            "http_password": "",
            "hostid": "10084",
            "templateid": "0",
            "http_proxy": "",
            "retries": "1",
            "ssl_cert_file": "",
            "ssl_key_file": "",
            "ssl_key_password": "",
            "verify_peer": "0",
            "verify_host": "0",
            "headers": [],
            "steps": [
                {
                    "httpstepid": "36",
                    "httptestid": "9",
                    "name": "Homepage",
                    "no": "1",
                    "url": "http://example.com",
                    "timeout": "15s",
                    "posts": "",
                    "required": "",
                    "status_codes": "200",
                    "variables": [
                        {
                            "name":"{var}",
                            "value":"12"
                        }
                    ],
                    "follow_redirects": "1",
                    "retrieve_mode": "0",
                    "headers": [],
                    "query_fields": []
                },
                {
                    "httpstepid": "37",
                    "httptestid": "9",
                    "name": "Homepage / About",
                    "no": "2",
                    "url": "http://example.com/about",
                    "timeout": "15s",
                    "posts": "",
                    "required": "",
                    "status_codes": "200",
                    "variables": [],
                    "follow_redirects": "1",
                    "retrieve_mode": "0",
                    "headers": [],
                    "query_fields": []
                }
            ]
        }
    ],
    "id": 1
}

Skatiet arī

Avots

CHttpTest::get() failā ui/include/classes/api/services/CHttpTest.php.