maintenance.update

Apraksts

object maintenance.update(object/array maintenances)

Šī metode ļauj atjaunināt esošās apkalpošanas.

Šī 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) Uzturēšanas rekvizīti, kas jāatjaunina.

Katram uzturēšanas periodam ir jābūt definētam rekvizītam maintenanceid, visi pārējie rekvizīti nav obligāti. Tiks atjaunināti tikai nodotie rekvizīti, bet visi pārējie paliks nemainīti.

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

Parameter Type Description
groups object/array Hosts grupas, ar kurām aizstāt pašreizējās grupas.

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, ar kuriem aizstāt pašreizējos hosts.

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, ar kuriem aizstāt pašreizējos trigerus.

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, ar kuriem aizstāt pašreizējos notikumu nosaukumus.

Parametra darbība:
- atbalstīts, ja maintenance_type=0 (ar datu apkopošanu)
tags object/array Problēmu tagi, ar kuriem aizstāt pašreizējos tagus.

Parametra darbība:
- atbalstīts, ja Maintenance object rekvizīts maintenance_type ir iestatīts uz "ar datu apkopošanu"
timeperiods object/array Uzturēšanas laikposmi, ar kuriem aizstāt pašreizējos laikposmus.

Atgrieztās vērtības

(object) Atgriež objektu, kas satur atjaunināto uzturēšanas ierakstu ID īpašībā maintenanceids.

Piemēri

Dažādu hostu piešķiršana

Aizstājiet hostus, kas pašlaik piešķirti uzturēšanai, ar diviem citiem.

Pieprasījums:

{
    "jsonrpc": "2.0",
    "method": "maintenance.update",
    "params": {
        "maintenanceid": "3",
        "hosts": [
            {"hostid": "10085"},
            {"hostid": "10084"}
        ]
    },
    "id": 1
}

Atbilde:

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

Skatīt arī

Avots

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