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 darbi, ko izveidot.

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

Parameter Type Description
groups object/array Hostu grupas, kurām tiks veikta uzturēšana.

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

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

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

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

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

Definē, kuras problēmas ir jāslāpē.
Ja tagi nav norādīti, tiks slāpētas visas aktīvās uzturēšanas hostu problēmas.

Parametra uzvedība:
- atbalstīts, ja Uzturēšanas objekta maintenance_type ir iestatīts uz "with data collection"
groupids
(deprecated)		 array Šis parametrs ir novecojis, lūdzu, izmantojiet groups.
Hostu grupu ID, kurām tiks veikta uzturēšana.
hostids
(deprecated)		 array Šis parametrs ir novecojis, lūdzu, izmantojiet hosts.
Hostu ID, kuriem tiks veikta uzturēšana.

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.