maintenance.get

Apraksts

integer/array maintenance.get(object parameters)

Metode ļauj izgūt uzturēšanas 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 uzturēšanas darbus, kas ir piešķirti norādītajām host grupām.
hostids ID/array Atgriezt tikai uzturēšanas darbus, kas ir piešķirti norādītajiem hosts.
maintenanceids ID/array Atgriezt tikai uzturēšanas darbus ar norādītajiem ID.
selectHostGroups query Atgriezt hostgroups īpašību ar host grupām, kas piešķirtas uzturēšanas darbam.
selectHosts query Atgriezt hosts īpašību ar hosts, kas piešķirti uzturēšanas darbam.
selectTags query Atgriezt tags īpašību ar uzturēšanas darba problēmu tagiem.
selectTimeperiods query Atgriezt timeperiods īpašību ar uzturēšanas darba laika periodiem.
sortfield string/array Kārtot rezultātu pēc norādītajām īpašībām.

Iespējamās vērtības: maintenanceid, name, maintenance_type, active_since, active_till.
countOutput boolean Šie parametri ir aprakstīti atsauces komentāros.
editable boolean
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean
selectGroups
(deprecated)		 query Šis parametrs ir novecojis, lūdzu, izmantojiet selectHostGroups.
Atgriezt groups īpašību ar host grupām, kas piešķirtas uzturēšanas darbam.

Atgrieztās vērtības

(integer/array) Atgriež vai nu:

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

Piemēri

Uzturēšanas periodu izgūšana

Izgūstiet visus konfigurētos uzturēšanas periodus un datus par piešķirtajām hostu grupām, definētajiem laika periodiem un problēmu tagiem.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "maintenance.get",
    "params": {
        "output": "extend",
        "selectHostGroups": "extend",
        "selectTimeperiods": "extend",
        "selectTags": "extend"
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "maintenanceid": "3",
            "name": "Sunday maintenance",
            "maintenance_type": "0",
            "description": "",
            "active_since": "1358844540",
            "active_till": "1390466940",
            "tags_evaltype": "0",
            "hostgroups": [
                {
                    "groupid": "4",
                    "name": "Zabbix servers",
                    "flags": "0",
                    "uuid": "6f6799aa69e844b4b3918f779f2abf08"
                }
            ],
            "timeperiods": [
                {
                    "timeperiod_type": "3",
                    "every": "1",
                    "month": "0",
                    "dayofweek": "1",
                    "day": "0",
                    "start_time": "64800",
                    "period": "3600",
                    "start_date": "2147483647"
                }
            ],
            "tags": [
                {
                    "tag": "service",
                    "operator": "0",
                    "value": "mysqld",
                },
                {
                    "tag": "error",
                    "operator": "2",
                    "value": ""
                }
            ]
        }
    ],
    "id": 1
}

Skatiet arī

Avots

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