maintenance.update

Beschreibung

object maintenance.update(object/array maintenances)

Diese Methode ermöglicht die Aktualisierung bestehender Wartungen.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigung zum Aufrufen der Methode kann in den Benutzerrolleneinstellungen entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu aktualisierende Wartungseigenschaften.

Die Eigenschaft maintenanceid muss für jede Wartung definiert sein, alle anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den standardmäßigen Wartungseigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Typ Beschreibung
groups object/array Hostgruppen, die die aktuellen Gruppen ersetzen.

Die Hostgruppen dürfen nur die Eigenschaft groupid definiert haben.

Parameterverhalten:
- erforderlich, wenn hosts nicht gesetzt ist
hosts object/array Hosts, die die aktuellen Hosts ersetzen.

Die Hosts dürfen nur die Eigenschaft hostid definiert haben.

Parameterverhalten:
- erforderlich, wenn groups nicht gesetzt ist
timeperiods object/array Wartungs-Zeitperioden, die die aktuellen Perioden ersetzen.
tags object/array Problem-Tags, die die aktuellen Tags ersetzen.

Parameterverhalten:
- unterstützt, wenn maintenance_type des Wartungsobjekts auf "with data collection" gesetzt ist
groupids
(deprecated)		 array Dieser Parameter ist veraltet, bitte verwenden Sie stattdessen groups.
IDs der Hostgruppen, die gewartet werden.
hostids
(deprecated)		 array Dieser Parameter ist veraltet, bitte verwenden Sie stattdessen hosts.
IDs der Hosts, die gewartet werden.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Wartung unter der Eigenschaft maintenanceids enthält.

Beispiele

Zuweisen verschiedener Hosts

Ersetzen Sie die Hosts, die derzeit der Wartung zugewiesen sind, durch zwei andere.

Anfrage:

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

Antwort:

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

Siehe auch

Quelle

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