maintenance.update

Opis

object maintenance.update(object/array maintenances)

Ta metoda umożliwia aktualizację istniejących konserwacji.

Ta metoda jest dostępna tylko dla użytkowników typu Admin i Super admin. Uprawnienia do wywołania metody można odwołać w ustawieniach roli użytkownika. Więcej informacji można znaleźć w User roles.

Parametry

(object/array) Właściwości maintenance do zaktualizowania.

Właściwość maintenanceid musi być zdefiniowana dla każdego maintenance, wszystkie pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane właściwości, wszystkie pozostałe pozostaną bez zmian.

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

Parametr Typ Opis
groups object/array Grupy hostów zastępujące bieżące grupy.

Grupy hostów muszą mieć zdefiniowaną tylko właściwość groupid.

Zachowanie parametru:
- wymagane, jeśli hosts nie jest ustawione
hosts object/array Hosty zastępujące bieżące hosty.

Hosty muszą mieć zdefiniowaną tylko właściwość hostid.

Zachowanie parametru:
- wymagane, jeśli groups nie jest ustawione
timeperiods object/array Okresy czasu maintenance zastępujące bieżące okresy.
tags object/array Tagi problemów zastępujące bieżące tagi.

Zachowanie parametru:
- obsługiwane, jeśli maintenance_type obiektu Maintenance object jest ustawione na "with data collection"

Wartości zwracane

(object) Zwraca obiekt zawierający identyfikatory zaktualizowanych konserwacji w ramach właściwości maintenanceids.

Przykłady

Przypisywanie różnych hostów

Zastąp hosty aktualnie przypisane do konserwacji dwoma innymi.

Żądanie:

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

Odpowiedź:

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

Zobacz także

Źródło

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