maintenance.update

Opis

object maintenance.update(object/array maintenances)

Ta metoda umożliwia aktualizację istniejących okresów utrzymania.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania metody można odebrać w ustawieniach ról użytkownika. Zobacz Role użytkownika aby uzyskać więcej informacji.

Parametry

(object/array) Właściwości okresów utrzymania do zaktualizowania.

Właściwość maintenanceid musi być zdefiniowana dla każdego okresu utrzymania, wszystkie inne właściwości są opcjonalne. Tylko przekazane właściwości zostaną zaktualizowane, wszystkie inne pozostaną niezmienione.

Oprócz standardowych właściwości okresów utrzymania, metoda akceptuje następujące parametry.

Parametr	Typ	Opis
groups	object/array	Grupy hostów, które zastąpią bieżące grupy. Grupy hostów muszą mieć zdefiniowaną właściwość `groupid`.
hosts	object/array	Hosty, które zastąpią bieżące hosty. Hosty muszą mieć zdefiniowaną właściwość `hostid`.
timeperiods	object/array	Okresy czasu okresu utrzymania, które zastąpią bieżące okresy czasu.
tags	object/array	Znaczniki problemów, które zastąpią bieżące tagi.
groupids (przestarzałe)	array	Ten parametr jest przestarzały, należy użyć `groups` zamiast niego. IDs grup hostów, które będą objęte utrzymaniem.
hostids (przestarzałe)	array	Ten parametr jest przestarzały, należy użyć `hosts` zamiast niego. IDs hostów, które będą objęte utrzymaniem.

Dla każdego okresu utrzymania musi być zdefiniowany co najmniej jeden host lub grupa hostów.

Zwracane wartości

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych okresów utrzymania we właściwości maintenanceids.

Przykłady

Przypisywanie różnych hostów

Zastąp hosty aktualnie przypisane do okresu utrzymania dwoma innymi.

Zapytanie:

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

Odpowiedź:

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

Zobacz także

Okres czasu

Źródło

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

Documentation