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 nosaka vēlamo izvadi.

Metode atbalsta šādus parametrus.

Parametrs Tips Apraksts
groupids ID/array Atgriezt tikai tās uzturēšanas, kas ir piešķirtas norādītajām hostu grupām.
hostids ID/array Atgriezt tikai tās uzturēšanas, kas ir piešķirtas norādītajiem hostiem.
maintenanceids ID/array Atgriezt tikai uzturēšanas ar norādītajiem ID.
selectHostGroups query Atgriezt hostgroups īpašību ar hostu grupām, kas piešķirtas uzturēšanai.
selectHosts query Atgriezt hosts īpašību ar hostiem, kas piešķirti uzturēšanai.
selectTags query Atgriezt tags īpašību ar uzturēšanas problēmu birkām.
selectTimeperiods query Atgriezt timeperiods īpašību ar uzturēšanas 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ā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ž 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.