maintenance.create

Apraksts

object maintenance.create(object/array maintenances)

Šī metode ļauj izveidot jaunas apkopes.

Šī metode ir pieejama tikai Admin un Super admin lietotāju tipiem. Atļaujas izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet Lietotāju lomas.

Parametri

(object/array) Uzturēšanas ieraksti, ko izveidot.

Papildus standarta uzturēšanas īpašībām metode pieņem šādus parametrus.

Parametrs Tips Apraksts
groups object/array Hostu grupas, kurām tiks veikta uzturēšana.

Hostu grupām jābūt definētai tikai groupid īpašībai.

Parametra darbība:
- obligāts, ja hosts nav iestatīts
hosts object/array Hosti, kuriem tiks veikta uzturēšana.

Hostiem jābūt definētai tikai hostid īpašībai.

Parametra darbība:
- obligāts, ja groups nav iestatīts
timeperiods object/array Uzturēšanas laika periodi.

Parametra darbība:
- obligāts
tags object/array Problēmu birkas.

Definē, kuras problēmas ir jānomāc.
Ja birkas nav norādītas, tiks nomāktas visas aktīvās uzturēšanas hostu problēmas.

Parametra darbība:
- atbalstīts, ja Uzturēšanas objekta maintenance_type ir iestatīts uz "with data collection"

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

Uzturēšanas izveide

Izveidojiet uzturēšanu ar datu vākšanu hostu grupai ar ID "2" un ar 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āturpinās 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": "2"}
        ],
        "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
}

Skatiet arī

Avots

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