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 konserwacji do zaktualizowania.
Właściwość maintenanceid musi być zdefiniowana dla każdej konserwacji, wszystkie
pozostałe właściwości są opcjonalne. Zostaną zaktualizowane tylko przekazane właściwości,
wszystkie pozostałe pozostaną bez zmian.
Oprócz standardowych właściwości konserwacji metoda akceptuje następujące parametry.
| Parameter | Type | Description |
|---|---|---|
| groups | object/array | Grupy hostów do zastąpienia bieżących grup. Grupy hostów mogą mieć zdefiniowaną tylko właściwość groupid.Zachowanie parametru: - wymagany jeśli hosts nie jest ustawiony |
| hosts | object/array | Hosty do zastąpienia bieżących hostów. Hosty mogą mieć zdefiniowaną tylko właściwość hostid.Zachowanie parametru: - wymagany jeśli groups nie jest ustawiony |
| timeperiods | object/array | Okresy czasu konserwacji do zastąpienia bieżących okresów. |
| tags | object/array | Tagi problemów do zastąpienia bieżących tagów. Zachowanie parametru: - obsługiwany jeśli maintenance_type obiektu Maintenance object jest ustawiony na "with data collection" |
| groupids (deprecated) |
array | Ten parametr jest przestarzały, użyj zamiast niego groups.Identyfikatory grup hostów, które zostaną objęte konserwacją. |
| hostids (deprecated) |
array | Ten parametr jest przestarzały, użyj zamiast niego hosts.Identyfikatory hostów, które zostaną objęte konserwacją. |
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.