maintenance.update
Opis
object maintenance.update(object/array maintenances)
Ta metoda umożliwia aktualizację istniejących konserwacji.
Ta metoda jest dostępna tylko dla typów użytkowników Admin i Super admin. Uprawnienia do wywołania tej metody można odebrać w ustawieniach roli użytkownika. Więcej informacji można znaleźć w sekcji Role użytkowników.
Parametry
(object/array) Właściwości konserwacji do zaktualizowania.
Właściwość maintenanceid musi być zdefiniowana dla każdej konserwacji, a wszystkie pozostałe właściwości są opcjonalne. Zostaną zaktualizowane tylko przekazane właściwości, a wszystkie pozostałe pozostaną niezmienione.
Oprócz standardowych właściwości konserwacji metoda akceptuje następujące parametry.
| Parameter | Type | Description |
|---|---|---|
| groups | object/array | Grupy hostów zastępujące bieżące grupy. Grupy hostów mogą mieć zdefiniowaną tylko właściwość groupid.Zachowanie parametru: - wymagany, jeśli nie ustawiono hosts |
| hosts | object/array | Hosty zastępujące bieżące hosty. Hosty mogą mieć zdefiniowaną tylko właściwość hostid.Zachowanie parametru: - wymagany, jeśli nie ustawiono groups |
| triggers | object/array | Wyzwalacze zastępujące bieżące wyzwalacze. Wyzwalacze mogą mieć zdefiniowaną tylko właściwość triggerid.Zachowanie parametru: - wymagany, jeśli nie ustawiono groups ani hosts- obsługiwany, jeśli maintenance_type=0 (ze zbieraniem danych) |
| event_names | object/array | Nazwy zdarzeń zastępujące bieżące nazwy zdarzeń. Zachowanie parametru: - obsługiwany, jeśli maintenance_type=0 (ze zbieraniem danych) |
| tags | object/array | Znaczniki problemów zastępujące bieżące znaczniki. Zachowanie parametru: - obsługiwany, jeśli właściwość maintenance_type obiektu konserwacji jest ustawiona na „ze zbieraniem danych” |
| timeperiods | object/array | Okresy konserwacji zastępujące bieżące okresy. |
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.
{
"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.