maintenance.update

Apraksts

object maintenance.update(object/array maintenances)

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

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

Parametri

(object/array) Uzturēšanas rekvizīti, kas jāatjaunina.

Rekvizīts maintenanceid ir jādefinē katrai uzturēšanai, visi pārējie rekvizīti ir izvēles. Tiks atjaunināti tikai nodotie rekvizīti, visi pārējie paliks nemainīgi.

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

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

Host grupām jābūt definētam tikai rekvizītam groupid.

Parametra uzvedība:
- required ja hosts nav iestatīts
hosts object/array Hosts, ar kuriem aizstāt pašreizējos hosts.

Hosts jābūt definētam tikai rekvizītam hostid.

Parametra uzvedība:
- required ja groups nav iestatīts
timeperiods object/array Uzturēšanas laika periodi, ar kuriem aizstāt pašreizējos periodus.
tags object/array Problēmu tagi, ar kuriem aizstāt pašreizējos tagus.

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

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.