maintenance.create

Apraksts

object maintenance.create(object/array maintenances)

Šī metode ļauj izveidot jaunus uzturēšanas darbus.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Tiesības izsaukt šo metodi var atsaukt lietotāju lomu iestatījumos. Plašāku informāciju skatiet sadaļā Lietotāju lomas.

Parametri

(object/array) Izveidojamās uzturēšanas.

Papildus standarta uzturēšanas rekvizītiem metode pieņem šādus parametrus.

Parameter Type Description
groups object/array Hosts grupas, kuras jāiekļauj uzturēšanā.

Hosts grupām drīkst būt definēts tikai rekvizīts groupid.

Parametra darbība:
- obligāts, ja hosts nav iestatīts
hosts object/array Hosts, kuri jāiekļauj uzturēšanā.

Hosts drīkst būt definēts tikai rekvizīts hostid.

Parametra darbība:
- obligāts, ja groups nav iestatīts
triggers object/array Trigeri, kuri jāiekļauj uzturēšanā.

Trigeriem drīkst būt definēts tikai rekvizīts triggerid.

Parametra darbība:
- obligāts, ja groups un hosts nav iestatīti
- atbalstīts, ja maintenance_type=0 (ar datu apkopošanu)
event_names object/array Notikumu nosaukumi, kas nosaka problēmas, kuras jāiekļauj uzturēšanā.

Parametra darbība:
- atbalstīts, ja maintenance_type=0 (ar datu apkopošanu)
tags object/array Problēmu tagi, kas nosaka problēmas, kuras jāiekļauj uzturēšanā.

Parametra darbība:
- atbalstīts, ja Maintenance object rekvizītam maintenance_type ir iestatīta vērtība "ar datu apkopošanu"
timeperiods object/array Uzturēšanas laika periodi.

Parametra darbība:
- obligāts

Atgrieztās vērtības

(object) Atgriež objektu, kas satur izveidoto uzturēšanu ID īpašībā maintenanceids. Atgriezto ID secība atbilst nodoto uzturēšanu secībai.

Piemēri

Apkopes izveide

Izveidojiet apkopi ar datu apkopošanu hostu grupai ar ID "20" un problēmu tagiem service:mysqld un error.
Tai jābūt aktīvai no 17.03.2026. līdz 17.03.2027., jāstājas spēkā katru svētdienu plkst. 18:00 un jāilgst vienu stundu.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "maintenance.create",
    "params": {
        "name": "Sunday maintenance",
        "active_since": 1773720240,
        "active_till": 1805256240,
        "tags_evaltype": 0,
        "groups": [
            {"groupid": "20"}
        ],
        "timeperiods": [
            {
                "period": 3600,
                "timeperiod_type": 3,
                "start_time": 64800,
                "every": 1,
                "dayofweek": 64
            }
        ],
        "tags": [
            {
                "tag": "service",
                "operator": "0",
                "value": "mysqld"
            },
            {
                "tag": "error",
                "operator": "2",
                "value": ""
            }
        ]
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "maintenanceids": [
            "3"
        ]
    },
    "id": 1
}

Ad-hoc uzturēšanas izveide

Izveidojiet vienu stundu ilgu ad-hoc uzturēšanu ar datu apkopošanu hosts grupai ar ID "4", trigerim ar ID "12345" un notikuma nosaukumam Printer: ink low.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "maintenance.create",
    "params": {
        "name": "Ad-hoc maintenance",
        "active_since": 1792057740,
        "active_till": 1792061340,
        "tags_evaltype": 0,
        "groups": [
            {"groupid": "4"}
        ],
        "triggers": [
            {"triggerid": "12345"}
        ],
        "timeperiods": [
            {
                "period": 3600,
                "timeperiod_type": 0,
                "start_date": 1792057740
            }
        ],
        "event_names": [
            {
                "operator": "2",
                "value": "Printer: ink low"
            }
        ]
    },
    "id": 1
}

Atbilde:

{
    "jsonrpc": "2.0",
    "result": {
        "maintenanceids": [
            "4"
        ]
    },
    "id": 1
}

Skatiet arī

Avots

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